@koda-sl/baker-cli 0.466.0 → 0.468.0

package/dist/publish-YWTFFCDB.js

@@ -0,0 +1,322 @@
+import {
+  advanceDefinitionStatus,
+  definitionPathFor
+} from "./chunk-3ACMDRSE.js";
+import {
+  defaultVideoApiDeps,
+  detectVideoContentType,
+  isVideoFile,
+  uploadLocalVideo,
+  videoProcessingTimeoutMs,
+  waitForPlayableVideo
+} from "./chunk-MD3VH5UG.js";
+import {
+  defaultImageApiDeps,
+  detectImageContentType,
+  imageProcessingTimeoutMs,
+  publishImageAsCreative,
+  uploadImageBytes,
+  uploadLocalImage,
+  waitForReadyImage
+} from "./chunk-SFHL3KWY.js";
+import {
+  fetchRunRecord
+} from "./chunk-P72PL3UG.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-F3IVR3V3.js";
+import {
+  sha256Hex
+} from "./chunk-DJPCTTUN.js";
+import "./chunk-BJEW3LST.js";
+import "./chunk-SSVZM3P6.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  ApiError
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import {
+  optionalChatId
+} from "./chunk-YPCVPDU7.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/publish.ts
+import { Buffer } from "buffer";
+import { defineCommand } from "citty";
+var creativeContentTypes = ["image/png", "image/jpeg", "image/webp"];
+var creativeVideoContentTypes = ["video/mp4", "video/quicktime", "video/webm"];
+var UNSUPPORTED_CREATIVE_FILE = "Unsupported creative file extension. Use PNG, JPG or WebP for an image, MP4, MOV or WebM for a video.";
+var DESCRIPTION = `Save a finished creative to Baker Creatives and return a creative reference: a static image (PNG/JPG/WebP) or a finished video render (MP4/MOV/WebM).
+Start here:
+  baker creatives publish ./canvas/r_01K\u2026/final_4x5.png --title "Spring Offer" --slug spring-offer --run-id r_01K\u2026
+  baker creatives publish --title "Spring Offer" --slug spring-offer --run-id r_01K\u2026 --output 4:5
+  baker creatives publish ./canvas/r_01K\u2026/final.mp4 --title "Spring Offer Reel" --slug spring-offer --run-id r_01K\u2026
+With --run-id and no file, the run's own saved image is published (--output picks one when the run made several). A video goes to the company's video library first and is saved once it plays (up to 3 minutes); it needs the file and --slug. Choose and save the finished version yourself, including in the turn that rendered it. Saving pins that version without recording user approval or putting an ad live. An image publish marks the creative's _definition.md published.`;
+var ARGS = {
+  file: {
+    type: "string",
+    description: "Local creative file: PNG/JPG/WebP image or MP4/MOV/WebM video. Optional for an image with --run-id: the run's saved output is used instead.",
+    required: false
+  },
+  title: { type: "string", description: "Human title for the creative output", required: true },
+  context: { type: "string", description: "Optional describe context for the image asset", required: false },
+  sourceReferenceUrl: {
+    type: "string",
+    description: "Optional URL of the original reference ad",
+    required: false
+  },
+  slug: {
+    type: "string",
+    description: "Creative slug (src/creatives/<slug>/). Attaches the image or video to that creative's row. Required for a video",
+    required: false
+  },
+  runId: {
+    type: "string",
+    description: "Canvas run id (r_\u2026) of the finished generation to pin as published",
+    required: false
+  },
+  output: {
+    type: "string",
+    description: "With --run-id and no file: which of the run's outputs to save when it made several, by label (e.g. 4:5), slot, or number (1 = first).",
+    required: false
+  }
+};
+registerSchema({ command: "creatives.publish", description: DESCRIPTION, args: ARGS });
+function detectCreativeContentType(filePath) {
+  return detectImageContentType(filePath, {
+    allowedContentTypes: creativeContentTypes,
+    unsupportedMessage: UNSUPPORTED_CREATIVE_FILE
+  });
+}
+function chatIdFromEnv() {
+  return optionalChatId();
+}
+function parseOptionalUrl(value) {
+  if (value === void 0 || value.trim() === "") {
+    return void 0;
+  }
+  try {
+    return new URL(value).toString();
+  } catch {
+    throw new ApiError("VALIDATION_ERROR", "--source-reference-url must be a valid URL");
+  }
+}
+async function downloadBytes(url) {
+  const res = await fetch(url);
+  if (!res.ok) throw new ApiError("UNAVAILABLE", `Could not read the run's output (${res.status} ${res.statusText})`);
+  return Buffer.from(await res.arrayBuffer());
+}
+function runImages(run) {
+  if (run.status !== "completed") {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      `Run ${run.runId} did not finish (${run.status}), so it has no result to publish. Finish the run first, or pass the image file.`
+    );
+  }
+  const finals = run.finalOutputs.filter((o) => typeof o.url === "string");
+  if (finals.some((o) => !creativeContentTypes.some((t) => t === o.mime))) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      `Run ${run.runId} made a video, not a still image. Publish the video file: baker creatives publish ./canvas/${run.runId}/<file>.mp4 --slug <slug> --run-id ${run.runId}.`
+    );
+  }
+  return finals;
+}
+function describeOutputs(outputs) {
+  return outputs.map((o, i) => `${i + 1}: ${o.label ?? o.slot}`).join(", ");
+}
+function chooseOutput(run, choice) {
+  const images = runImages(run);
+  if (images.length === 0) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      `Run ${run.runId} has no saved image to publish. Pass the image file instead.`
+    );
+  }
+  if (choice === void 0) {
+    const [only] = images;
+    if (images.length === 1 && only) return only;
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      `Run ${run.runId} made ${images.length} images; pick one with --output (${describeOutputs(images)}).`
+    );
+  }
+  const wanted = choice.trim();
+  const byNumber = /^\d+$/.test(wanted) ? images[Number(wanted) - 1] : void 0;
+  const found = byNumber ?? images.find((o) => o.label === wanted || o.slot === wanted);
+  if (!found) {
+    throw new ApiError("VALIDATION_ERROR", `Run ${run.runId} has no output "${wanted}" (${describeOutputs(images)}).`);
+  }
+  return found;
+}
+var EXTENSION = { "image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp" };
+async function uploadRunOutput(args, deps) {
+  const run = await fetchRunRecord(args.runId, deps.post);
+  if (!run) {
+    throw new ApiError(
+      "NOT_FOUND",
+      `No run "${args.runId}" in this company's run history. Pass the image file instead.`
+    );
+  }
+  const chosen = chooseOutput(run, args.output);
+  const bytes = await (deps.download ?? downloadBytes)(String(chosen.url));
+  if (sha256Hex(bytes) !== chosen.sha256) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      `The saved output of run ${run.runId} does not match its recorded fingerprint`
+    );
+  }
+  const name = (chosen.label ?? chosen.slot).replace(/[^a-z0-9.-]+/gi, "_");
+  return uploadImageBytes(
+    {
+      bytes,
+      contentType: chosen.mime,
+      originalFilename: `${run.runId}-${name}${EXTENSION[chosen.mime] ?? ""}`,
+      source: "ai_generated",
+      descriptionContext: args.descriptionContext
+    },
+    deps
+  );
+}
+async function publishCreative(args, deps = defaultImageApiDeps) {
+  const title = args.title.trim();
+  if (!title) {
+    throw new ApiError("VALIDATION_ERROR", "--title is required");
+  }
+  const sourceReferenceUrl = parseOptionalUrl(args.sourceReferenceUrl);
+  const descriptionContext = args.context ?? `Static ad creative: ${title}`;
+  let upload;
+  if (args.file) {
+    upload = await uploadLocalImage(
+      {
+        file: args.file,
+        contentType: detectCreativeContentType(args.file),
+        source: "ai_generated",
+        descriptionContext
+      },
+      deps
+    );
+  } else if (args.runId) {
+    upload = await uploadRunOutput(
+      {
+        runId: args.runId,
+        output: args.output,
+        descriptionContext
+      },
+      deps
+    );
+  } else {
+    throw new ApiError("VALIDATION_ERROR", "Pass the image file, or --run-id to save the run's own output");
+  }
+  await waitForReadyImage(deps, upload.imageId, { timeoutMs: imageProcessingTimeoutMs });
+  const result = await publishImageAsCreative(deps, {
+    imageId: upload.imageId,
+    title,
+    sourceReferenceUrl,
+    slug: args.slug,
+    runId: args.runId,
+    // Attribute the publish to the driving chat (injected by the bridge).
+    chatId: chatIdFromEnv()
+  });
+  if (args.slug && args.runId) {
+    const cwd = process.cwd();
+    const root = deps.workspaceRoot ?? findWorkspaceRoot(cwd) ?? cwd;
+    const status = await advanceDefinitionStatus(definitionPathFor(root, args.slug), "published");
+    if (status === "updated") return { ...result, definitionStatus: "published" };
+  }
+  return result;
+}
+async function publishVideoCreative(args, deps = defaultVideoApiDeps) {
+  const title = args.title.trim();
+  if (!title) {
+    throw new ApiError("VALIDATION_ERROR", "--title is required");
+  }
+  const slug = args.slug?.trim();
+  if (!slug) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      "--slug is required for a video: name the creative (src/creatives/<slug>/) this render belongs to"
+    );
+  }
+  const sourceReferenceUrl = parseOptionalUrl(args.sourceReferenceUrl);
+  const contentType = detectVideoContentType(args.file, {
+    allowedContentTypes: creativeVideoContentTypes,
+    unsupportedMessage: UNSUPPORTED_CREATIVE_FILE
+  });
+  const { videoId } = await uploadLocalVideo(
+    { file: args.file, contentType, descriptionContext: args.context ?? `Video ad creative: ${title}` },
+    deps
+  );
+  await waitForPlayableVideo(deps, videoId, { timeoutMs: videoProcessingTimeoutMs });
+  const body = { videoId, title, slug };
+  if (args.runId) body.runId = args.runId;
+  if (sourceReferenceUrl) body.sourceReferenceUrl = sourceReferenceUrl;
+  const chatId = chatIdFromEnv();
+  if (chatId) body.chatId = chatId;
+  return deps.post("/api/creatives/publish-video", body);
+}
+var publishCommand = defineCommand({
+  meta: { name: "publish", description: DESCRIPTION },
+  // Checked in `run` rather than by citty, so a missing value answers with the JSON envelope.
+  args: { ...ARGS, file: { ...ARGS.file, type: "positional" }, title: { ...ARGS.title, required: false } },
+  run: async ({ args }) => {
+    try {
+      const file = args.file;
+      const title = args.title;
+      const runId = args.runId;
+      if (!file && !runId) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: "Image or video path is required (or --run-id to save the run's own image)"
+          }
+        });
+        process.exit(1);
+      }
+      if (!title) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "--title is required" } });
+        process.exit(1);
+      }
+      const publishArgs = {
+        file: file || void 0,
+        title,
+        context: args.context,
+        sourceReferenceUrl: args.sourceReferenceUrl,
+        slug: args.slug,
+        runId
+      };
+      if (file && isVideoFile(file)) {
+        writeJson(await publishVideoCreative({ ...publishArgs, file }));
+        return;
+      }
+      const data = await publishCreative({
+        ...publishArgs,
+        output: args.output
+      });
+      writeJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  detectCreativeContentType,
+  publishCommand,
+  publishCreative,
+  publishVideoCreative
+};
+//# sourceMappingURL=publish-YWTFFCDB.js.map

package/dist/publish-YWTFFCDB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/creatives/publish.ts"],"sourcesContent":["import { Buffer } from \"node:buffer\";\nimport type {\n  CreativesPublishVideoRequest,\n  CreativesPublishVideoResponse,\n  CreativesRunData,\n  CreativesRunOutput,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError } from \"../../client.ts\";\nimport { sha256Hex } from \"../../engine/storage/sha256.ts\";\nimport { optionalChatId } from \"../../env.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { advanceDefinitionStatus, definitionPathFor } from \"../canvas/definition-status.ts\";\nimport { findWorkspaceRoot } from \"../canvas/normalize-paths.ts\";\nimport { fetchRunRecord } from \"../canvas/run-history.ts\";\nimport {\n  defaultImageApiDeps,\n  detectImageContentType,\n  type ImageApiDeps,\n  imageProcessingTimeoutMs,\n  publishImageAsCreative,\n  uploadImageBytes,\n  uploadLocalImage,\n  waitForReadyImage,\n} from \"../images/api.ts\";\nimport {\n  defaultVideoApiDeps,\n  detectVideoContentType,\n  isVideoFile,\n  uploadLocalVideo,\n  type VideoApiDeps,\n  videoProcessingTimeoutMs,\n  waitForPlayableVideo,\n} from \"../videos/api.ts\";\n\nconst creativeContentTypes = [\"image/png\", \"image/jpeg\", \"image/webp\"] as const;\nconst creativeVideoContentTypes = [\"video/mp4\", \"video/quicktime\", \"video/webm\"] as const;\nconst UNSUPPORTED_CREATIVE_FILE =\n  \"Unsupported creative file extension. Use PNG, JPG or WebP for an image, MP4, MOV or WebM for a video.\";\n\ntype CreativeReference = {\n  type: \"creative\";\n  slug: string;\n  creativeId: string;\n  title: string;\n  asset: {\n    kind: \"static_image\";\n    imageId: string;\n    imageUrl: string;\n    storageKey?: string;\n    width?: number;\n    height?: number;\n    aspectRatio?: number;\n  };\n  imageUrl: string;\n  thumbnailUrl: string;\n  storageKey?: string;\n  sourceReferenceUrl?: string;\n  width?: number;\n  height?: number;\n  aspectRatio?: number;\n};\n\ntype CreativesPublishResult = {\n  creativeId: string;\n  imageId: string;\n  reference: CreativeReference;\n  /** Set when `src/creatives/<slug>/_definition.md` was moved to `published`. */\n  definitionStatus?: \"published\";\n};\n\nconst DESCRIPTION = `Save a finished creative to Baker Creatives and return a creative reference: a static image (PNG/JPG/WebP) or a finished video render (MP4/MOV/WebM).\nStart here:\n  baker creatives publish ./canvas/r_01K…/final_4x5.png --title \"Spring Offer\" --slug spring-offer --run-id r_01K…\n  baker creatives publish --title \"Spring Offer\" --slug spring-offer --run-id r_01K… --output 4:5\n  baker creatives publish ./canvas/r_01K…/final.mp4 --title \"Spring Offer Reel\" --slug spring-offer --run-id r_01K…\nWith --run-id and no file, the run's own saved image is published (--output picks one when the run made several). A video goes to the company's video library first and is saved once it plays (up to 3 minutes); it needs the file and --slug. Choose and save the finished version yourself, including in the turn that rendered it. Saving pins that version without recording user approval or putting an ad live. An image publish marks the creative's _definition.md published.`;\n\nconst ARGS = {\n  file: {\n    type: \"string\",\n    description:\n      \"Local creative file: PNG/JPG/WebP image or MP4/MOV/WebM video. Optional for an image with --run-id: the run's saved output is used instead.\",\n    required: false,\n  },\n  title: { type: \"string\", description: \"Human title for the creative output\", required: true },\n  context: { type: \"string\", description: \"Optional describe context for the image asset\", required: false },\n  sourceReferenceUrl: {\n    type: \"string\",\n    description: \"Optional URL of the original reference ad\",\n    required: false,\n  },\n  slug: {\n    type: \"string\",\n    description:\n      \"Creative slug (src/creatives/<slug>/). Attaches the image or video to that creative's row. Required for a video\",\n    required: false,\n  },\n  runId: {\n    type: \"string\",\n    description: \"Canvas run id (r_…) of the finished generation to pin as published\",\n    required: false,\n  },\n  output: {\n    type: \"string\",\n    description:\n      \"With --run-id and no file: which of the run's outputs to save when it made several, by label (e.g. 4:5), slot, or number (1 = first).\",\n    required: false,\n  },\n} as const;\n\nregisterSchema({ command: \"creatives.publish\", description: DESCRIPTION, args: ARGS });\n\nexport function detectCreativeContentType(filePath: string): string {\n  return detectImageContentType(filePath, {\n    allowedContentTypes: creativeContentTypes,\n    unsupportedMessage: UNSUPPORTED_CREATIVE_FILE,\n  });\n}\n\nfunction chatIdFromEnv(): string | undefined {\n  // Soft read: publish attribution is best-effort. Direct callers (tests,\n  // local one-offs) may run without the full env contract — missing creds\n  // already fail loudly at the API call itself.\n  return optionalChatId();\n}\n\nfunction parseOptionalUrl(value: string | undefined): string | undefined {\n  if (value === undefined || value.trim() === \"\") {\n    return undefined;\n  }\n\n  try {\n    return new URL(value).toString();\n  } catch {\n    throw new ApiError(\"VALIDATION_ERROR\", \"--source-reference-url must be a valid URL\");\n  }\n}\n\n/** What publishing needs beyond the image API: fetching a run's output, and where the workspace is. */\nexport type PublishDeps = ImageApiDeps & {\n  download?: (url: string) => Promise<Buffer>;\n  workspaceRoot?: string;\n};\n\nasync function downloadBytes(url: string): Promise<Buffer> {\n  const res = await fetch(url);\n  if (!res.ok) throw new ApiError(\"UNAVAILABLE\", `Could not read the run's output (${res.status} ${res.statusText})`);\n  return Buffer.from(await res.arrayBuffer());\n}\n\n/**\n * The run's result, when it is still images, in the order the run delivered them. Only the\n * final outputs of a finished run count: the frames and reference sheets its steps made on\n * the way are images too, and publishing one of those would save a stand-in as the creative.\n */\nfunction runImages(run: CreativesRunData): CreativesRunOutput[] {\n  if (run.status !== \"completed\") {\n    throw new ApiError(\n      \"VALIDATION_ERROR\",\n      `Run ${run.runId} did not finish (${run.status}), so it has no result to publish. Finish the run first, or pass the image file.`,\n    );\n  }\n  const finals = run.finalOutputs.filter((o) => typeof o.url === \"string\");\n  if (finals.some((o) => !creativeContentTypes.some((t) => t === o.mime))) {\n    throw new ApiError(\n      \"VALIDATION_ERROR\",\n      `Run ${run.runId} made a video, not a still image. Publish the video file: baker creatives publish ./canvas/${run.runId}/<file>.mp4 --slug <slug> --run-id ${run.runId}.`,\n    );\n  }\n  return finals;\n}\n\nfunction describeOutputs(outputs: CreativesRunOutput[]): string {\n  return outputs.map((o, i) => `${i + 1}: ${o.label ?? o.slot}`).join(\", \");\n}\n\n/** The one output to save: the only one, or the one `choice` names by label, slot or number. */\nfunction chooseOutput(run: CreativesRunData, choice: string | undefined): CreativesRunOutput {\n  const images = runImages(run);\n  if (images.length === 0) {\n    throw new ApiError(\n      \"VALIDATION_ERROR\",\n      `Run ${run.runId} has no saved image to publish. Pass the image file instead.`,\n    );\n  }\n  if (choice === undefined) {\n    const [only] = images;\n    if (images.length === 1 && only) return only;\n    throw new ApiError(\n      \"VALIDATION_ERROR\",\n      `Run ${run.runId} made ${images.length} images; pick one with --output (${describeOutputs(images)}).`,\n    );\n  }\n  const wanted = choice.trim();\n  const byNumber = /^\\d+$/.test(wanted) ? images[Number(wanted) - 1] : undefined;\n  const found = byNumber ?? images.find((o) => o.label === wanted || o.slot === wanted);\n  if (!found) {\n    throw new ApiError(\"VALIDATION_ERROR\", `Run ${run.runId} has no output \"${wanted}\" (${describeOutputs(images)}).`);\n  }\n  return found;\n}\n\nconst EXTENSION: Record<string, string> = { \"image/png\": \".png\", \"image/jpeg\": \".jpg\", \"image/webp\": \".webp\" };\n\n/**\n * Upload the run's saved output, byte for byte: the version that was chosen, not whichever\n * local file happens to sit at a path (and it works in a workspace that never had one).\n */\nasync function uploadRunOutput(\n  args: {\n    runId: string;\n    output: string | undefined;\n    descriptionContext: string;\n  },\n  deps: PublishDeps,\n): Promise<{ imageId: string }> {\n  const run = await fetchRunRecord(args.runId, deps.post);\n  if (!run) {\n    throw new ApiError(\n      \"NOT_FOUND\",\n      `No run \"${args.runId}\" in this company's run history. Pass the image file instead.`,\n    );\n  }\n  const chosen = chooseOutput(run, args.output);\n  const bytes = await (deps.download ?? downloadBytes)(String(chosen.url));\n  if (sha256Hex(bytes) !== chosen.sha256) {\n    throw new ApiError(\n      \"VALIDATION_ERROR\",\n      `The saved output of run ${run.runId} does not match its recorded fingerprint`,\n    );\n  }\n  const name = (chosen.label ?? chosen.slot).replace(/[^a-z0-9.-]+/gi, \"_\");\n  return uploadImageBytes(\n    {\n      bytes,\n      contentType: chosen.mime,\n      originalFilename: `${run.runId}-${name}${EXTENSION[chosen.mime] ?? \"\"}`,\n      source: \"ai_generated\",\n      descriptionContext: args.descriptionContext,\n    },\n    deps,\n  );\n}\n\nexport async function publishCreative(\n  args: {\n    file?: string;\n    title: string;\n    context?: string;\n    sourceReferenceUrl?: string;\n    slug?: string;\n    runId?: string;\n    output?: string;\n  },\n  deps: PublishDeps = defaultImageApiDeps,\n): Promise<CreativesPublishResult> {\n  const title = args.title.trim();\n  if (!title) {\n    throw new ApiError(\"VALIDATION_ERROR\", \"--title is required\");\n  }\n\n  const sourceReferenceUrl = parseOptionalUrl(args.sourceReferenceUrl);\n  const descriptionContext = args.context ?? `Static ad creative: ${title}`;\n  let upload: { imageId: string };\n  if (args.file) {\n    upload = await uploadLocalImage(\n      {\n        file: args.file,\n        contentType: detectCreativeContentType(args.file),\n        source: \"ai_generated\",\n        descriptionContext,\n      },\n      deps,\n    );\n  } else if (args.runId) {\n    upload = await uploadRunOutput(\n      {\n        runId: args.runId,\n        output: args.output,\n        descriptionContext,\n      },\n      deps,\n    );\n  } else {\n    throw new ApiError(\"VALIDATION_ERROR\", \"Pass the image file, or --run-id to save the run's own output\");\n  }\n  await waitForReadyImage(deps, upload.imageId, { timeoutMs: imageProcessingTimeoutMs });\n  const result = await publishImageAsCreative(deps, {\n    imageId: upload.imageId,\n    title,\n    sourceReferenceUrl,\n    slug: args.slug,\n    runId: args.runId,\n    // Attribute the publish to the driving chat (injected by the bridge).\n    chatId: chatIdFromEnv(),\n  });\n  // The lifecycle field moves with what happened: saving a finished version marks the\n  // creative published in its definition, so nobody edits it by hand.\n  if (args.slug && args.runId) {\n    const cwd = process.cwd();\n    const root = deps.workspaceRoot ?? findWorkspaceRoot(cwd) ?? cwd;\n    const status = await advanceDefinitionStatus(definitionPathFor(root, args.slug), \"published\");\n    if (status === \"updated\") return { ...result, definitionStatus: \"published\" };\n  }\n  return result;\n}\n\n/**\n * `baker creatives publish <video>`: upload the render to the company's video\n * library, wait until Baker can play it, then save it on the creative. The\n * image path above is untouched by this.\n */\nexport async function publishVideoCreative(\n  args: { file: string; title: string; context?: string; sourceReferenceUrl?: string; slug?: string; runId?: string },\n  deps: VideoApiDeps = defaultVideoApiDeps,\n): Promise<CreativesPublishVideoResponse> {\n  const title = args.title.trim();\n  if (!title) {\n    throw new ApiError(\"VALIDATION_ERROR\", \"--title is required\");\n  }\n  const slug = args.slug?.trim();\n  if (!slug) {\n    throw new ApiError(\n      \"VALIDATION_ERROR\",\n      \"--slug is required for a video: name the creative (src/creatives/<slug>/) this render belongs to\",\n    );\n  }\n  const sourceReferenceUrl = parseOptionalUrl(args.sourceReferenceUrl);\n  const contentType = detectVideoContentType(args.file, {\n    allowedContentTypes: creativeVideoContentTypes,\n    unsupportedMessage: UNSUPPORTED_CREATIVE_FILE,\n  });\n  const { videoId } = await uploadLocalVideo(\n    { file: args.file, contentType, descriptionContext: args.context ?? `Video ad creative: ${title}` },\n    deps,\n  );\n  await waitForPlayableVideo(deps, videoId, { timeoutMs: videoProcessingTimeoutMs });\n  const body: CreativesPublishVideoRequest = { videoId, title, slug };\n  if (args.runId) body.runId = args.runId;\n  if (sourceReferenceUrl) body.sourceReferenceUrl = sourceReferenceUrl;\n  const chatId = chatIdFromEnv();\n  if (chatId) body.chatId = chatId;\n  return deps.post<CreativesPublishVideoResponse>(\"/api/creatives/publish-video\", body);\n}\n\nexport const publishCommand = defineCommand({\n  meta: { name: \"publish\", description: DESCRIPTION },\n  // Checked in `run` rather than by citty, so a missing value answers with the JSON envelope.\n  args: { ...ARGS, file: { ...ARGS.file, type: \"positional\" }, title: { ...ARGS.title, required: false } },\n  run: async ({ args }) => {\n    try {\n      const file = args.file as string | undefined;\n      const title = args.title as string | undefined;\n      const runId = args.runId as string | undefined;\n      if (!file && !runId) {\n        writeJson({\n          ok: false,\n          error: {\n            code: \"VALIDATION_ERROR\",\n            message: \"Image or video path is required (or --run-id to save the run's own image)\",\n          },\n        });\n        process.exit(1);\n      }\n      if (!title) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"--title is required\" } });\n        process.exit(1);\n      }\n      const publishArgs = {\n        file: file || undefined,\n        title,\n        context: args.context as string | undefined,\n        sourceReferenceUrl: args.sourceReferenceUrl as string | undefined,\n        slug: args.slug as string | undefined,\n        runId,\n      };\n      if (file && isVideoFile(file)) {\n        writeJson(await publishVideoCreative({ ...publishArgs, file }));\n        return;\n      }\n      const data = await publishCreative({\n        ...publishArgs,\n        output: args.output as string | undefined,\n      });\n      writeJson({ ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/query-H54SCQ6D.js

@@ -0,0 +1,61 @@
+import {
+  buildFileSummary,
+  buildQueryEnvelope,
+  completenessWarnings,
+  effectiveRowLimit,
+  keywordServingOptions,
+  missingFieldWarnings,
+  missingFieldWarningsFor,
+  outputResults,
+  pageCacheKey,
+  parseQueryLimit,
+  parseSelectedFields,
+  queryCommand,
+  queryPageSize,
+  resolveGaqlInput,
+  resultColumns,
+  runQuery,
+  servingScopeWarnings,
+  shouldReadCache,
+  summariseWarnings,
+  unobservedFields,
+  unobservedSelectedFields,
+  unwrittenColumnWarnings,
+  warningLines
+} from "./chunk-42QCTCZK.js";
+import "./chunk-JPK34QPS.js";
+import "./chunk-5ZQ7S2P2.js";
+import "./chunk-7VHPAGPK.js";
+import "./chunk-6SL6463H.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildFileSummary,
+  buildQueryEnvelope,
+  completenessWarnings,
+  effectiveRowLimit,
+  keywordServingOptions,
+  missingFieldWarnings,
+  missingFieldWarningsFor,
+  outputResults,
+  pageCacheKey,
+  parseQueryLimit,
+  parseSelectedFields,
+  queryCommand,
+  queryPageSize,
+  resolveGaqlInput,
+  resultColumns,
+  runQuery,
+  servingScopeWarnings,
+  shouldReadCache,
+  summariseWarnings,
+  unobservedFields,
+  unobservedSelectedFields,
+  unwrittenColumnWarnings,
+  warningLines
+};
+//# sourceMappingURL=query-H54SCQ6D.js.map

package/dist/query-RK2TFMBI.js

@@ -0,0 +1,236 @@
+import {
+  resolvePropertyId
+} from "./chunk-PC56KVAD.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getQueryTtl,
+  handleConnectionError,
+  isNotConnectedError,
+  toCsvRow,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-6SL6463H.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ga4/query.ts
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { defineCommand } from "citty";
+
+// src/commands/ga4/presets.ts
+var GA4_PRESETS = [
+  {
+    name: "tracking-health",
+    description: "Compare GA4 sessions to GAds clicks \u2014 flag >20% discrepancy",
+    playbook: "[07] Discrepancy Check"
+  },
+  {
+    name: "lp-performance",
+    description: "Landing page UX diagnostic \u2014 flag duration <10s as message mismatch",
+    playbook: "[06] LP Diagnostic"
+  },
+  {
+    name: "traffic-quality",
+    description: "Warm traffic trap \u2014 flag >40% returning user conversions",
+    playbook: "[06] Warm Traffic Trap"
+  },
+  {
+    name: "funnel-leakage",
+    description: "Funnel drop-off analysis between form events",
+    playbook: "[06] Funnel Analysis"
+  },
+  {
+    name: "first-touch",
+    description: "First-touch attribution \u2014 true acquisition value of channels",
+    playbook: "First-Touch Attribution"
+  },
+  {
+    name: "traffic-overview",
+    description: "General traffic trends by date and source",
+    playbook: "General"
+  }
+];
+
+// src/commands/ga4/query.ts
+registerSchema({
+  command: "ga4.query",
+  description: "Run GA4 Data API reports. Use --preset for playbook-aligned queries (primary usage) or --dimensions/--metrics for free-form queries.",
+  args: {
+    "property-id": { type: "string", description: "GA4 property ID (auto-resolved if not provided)", required: false },
+    preset: {
+      type: "string",
+      description: "Named preset (tracking-health, lp-performance, traffic-quality, funnel-leakage, first-touch, traffic-overview)",
+      required: false
+    },
+    dimensions: { type: "string", description: "Comma-separated dimension names (escape hatch)", required: false },
+    metrics: { type: "string", description: "Comma-separated metric names (escape hatch)", required: false },
+    days: { type: "string", description: "Lookback window in days (default: 30)", required: false },
+    "start-date": {
+      type: "string",
+      description: "Explicit start date (YYYY-MM-DD or GA4 relative like '30daysAgo')",
+      required: false
+    },
+    "end-date": { type: "string", description: "Explicit end date (YYYY-MM-DD or 'yesterday')", required: false },
+    limit: { type: "string", description: "Max rows (default: 1000)", required: false },
+    "list-presets": { type: "boolean", description: "List available presets", required: false },
+    out: { type: "string", description: "Write data to file (.csv, .jsonl, .json)", required: false },
+    append: { type: "boolean", description: "Append to existing file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function extractFields(rows) {
+  const first = rows[0];
+  return first ? Object.keys(first) : [];
+}
+function writeRowsToFile(filePath, rows, append) {
+  const fields = extractFields(rows);
+  const ext = filePath.split(".").pop()?.toLowerCase();
+  if (ext === "csv") {
+    if (!append || !existsSync(filePath)) {
+      writeFileSync(filePath, `${toCsvRow(fields)}
+`, "utf-8");
+    }
+    const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
+    appendFileSync(filePath, `${csvRows.join("\n")}
+`, "utf-8");
+  } else if (ext === "jsonl") {
+    const lines = rows.map((row) => JSON.stringify(row));
+    const content = `${lines.join("\n")}
+`;
+    if (append && existsSync(filePath)) {
+      appendFileSync(filePath, content, "utf-8");
+    } else {
+      writeFileSync(filePath, content, "utf-8");
+    }
+  } else if (append && existsSync(filePath)) {
+    const existing = JSON.parse(readFileSync(filePath, "utf-8"));
+    writeFileSync(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
+  } else {
+    writeFileSync(filePath, JSON.stringify(rows, null, 2), "utf-8");
+  }
+}
+function outputRows(rows, args, response, cached) {
+  if (args.out) {
+    const filePath = resolve(args.out);
+    writeRowsToFile(filePath, rows, !!args.append);
+    writeJsonEnvelope({ ok: true, file: filePath, rows: rows.length, ...cached && { cached: true } });
+    return;
+  }
+  const format = args.output || "json";
+  if (format !== "json") {
+    writeAdsOutput(rows, format);
+    return;
+  }
+  writeJsonEnvelope({ ...response, ...cached && { cached: true } });
+}
+function buildRequestBody(args, propertyId, useCache) {
+  const body = { propertyId };
+  if (args.preset) body.preset = args.preset;
+  if (args.dimensions) body.dimensions = args.dimensions.split(",").map((d) => d.trim());
+  if (args.metrics) body.metrics = args.metrics.split(",").map((m) => m.trim());
+  if (args.days) body.days = Number(args.days);
+  if (args["start-date"]) body.startDate = args["start-date"];
+  if (args["end-date"]) body.endDate = args["end-date"];
+  if (args.limit) body.limit = Number(args.limit);
+  if (!useCache) body.skipCache = true;
+  return body;
+}
+function handleError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("ga4", err.message);
+    }
+    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+var queryCommand = defineCommand({
+  meta: {
+    name: "query",
+    description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
+
+Presets (primary usage):
+  baker ga4 query --preset tracking-health
+  baker ga4 query --preset lp-performance --days 14
+  baker ga4 query --list-presets
+
+Free-form (escape hatch):
+  baker ga4 query --dimensions "date,sessionSourceMedium" --metrics "sessions,conversions"
+  baker ga4 query --metrics "eventCount" --dimensions "eventName" --days 7`
+  },
+  args: {
+    "property-id": { type: "string", description: "GA4 property ID", required: false },
+    preset: { type: "string", description: "Named preset", required: false },
+    dimensions: { type: "string", description: "Comma-separated dimensions", required: false },
+    metrics: { type: "string", description: "Comma-separated metrics", required: false },
+    days: { type: "string", description: "Lookback days (default: 30)", required: false },
+    "start-date": { type: "string", description: "Start date override", required: false },
+    "end-date": { type: "string", description: "End date override", required: false },
+    limit: { type: "string", description: "Max rows (default: 1000)", required: false },
+    "list-presets": { type: "boolean", description: "List presets", required: false },
+    out: { type: "string", description: "Output file path", required: false },
+    append: { type: "boolean", description: "Append to file", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    if (args["list-presets"]) {
+      writeJsonEnvelope({
+        ok: true,
+        data: GA4_PRESETS.map((p) => ({ name: p.name, description: p.description, playbook: p.playbook }))
+      });
+      return;
+    }
+    if (!args.preset && !args.metrics) {
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Provide --preset or --metrics. Run --list-presets to see options."
+        }
+      });
+      process.exit(1);
+    }
+    const propertyId = await resolvePropertyId(args);
+    const useCache = !args["no-cache"];
+    const body = buildRequestBody(args, propertyId, useCache);
+    const cacheKey = buildQueryCacheKey(propertyId, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("ga4-queries", cacheKey);
+      if (cached) {
+        outputRows(cached.data.data ?? [], args, cached.data, true);
+        return;
+      }
+    }
+    try {
+      const response = await apiPost("/api/ga4/query", body);
+      if (useCache) {
+        cacheSet("ga4-queries", cacheKey, response, getQueryTtl(JSON.stringify(body)));
+      }
+      outputRows(response.data ?? [], args, response, false);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+export {
+  queryCommand
+};
+//# sourceMappingURL=query-RK2TFMBI.js.map