@koda-sl/baker-cli 0.523.0 → 0.524.0-dev.3eb5500a1

package/dist/chats-EG6UCN45.js

@@ -0,0 +1,279 @@
+import {
+  failApi
+} from "./chunk-XKRCO3JC.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-4U7HXXSA.js";
+import "./chunk-V6AAOAMM.js";
+import {
+  getEnv
+} from "./chunk-GGUQP6KI.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-L55PHMSR.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/chats/index.ts
+import { defineCommand } from "citty";
+
+// src/commands/chats/publish-hints.ts
+function publishHints(publish) {
+  const hints = [];
+  if (!publish.complete) {
+    const failed = publish.failedTotal;
+    hints.push(
+      `This Session's publish left ${failed} change${failed === 1 ? "" : "s"} behind \u2014 see \`publish.surfaces\` for the platform's own words. Do not report those changes as live.`
+    );
+  }
+  const unconfirmed = publish.unconfirmedTotal ?? 0;
+  if (unconfirmed > 0) {
+    hints.push(
+      `${unconfirmed} change${unconfirmed === 1 ? "" : "s"} went through but could not be confirmed when read back from the platform \u2014 \`publish.surfaces[].unconfirmedChanges\` says what it shows instead. Check before reporting them as done.`
+    );
+  }
+  return hints;
+}
+
+// src/commands/chats/index.ts
+var STATUS_GROUPS = ["active", "archived", "all"];
+var REPO_SURFACES = ["knowledge", "company", "brand", "landings", "flows", "creatives"];
+function parseBoundedInt(raw, name, min, max) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const value = Number.parseInt(raw, 10);
+  if (Number.isNaN(value) || value < min || value > max) {
+    throw new Error(`--${name} must be an integer between ${min} and ${max}`);
+  }
+  return value;
+}
+registerSchema({
+  command: "chats.list",
+  description: "Start here: list other Sessions on this account (newest first) so you can reuse what was done before. Each row shows the Session id, title, status, and a count of what it produced (creatives, landings, actions, flows, reports\u2026). Then drill in with `baker chats view <id>`, `baker chats transcript <id>`, or `baker chats diff <id>`. Read-only.",
+  args: {
+    status: { type: "string", description: "Filter: active|archived|all (default: all)", required: false },
+    limit: { type: "string", description: "Max Sessions to return, 1-100 (default: 20)", required: false },
+    full: { type: "boolean", description: "Include each Session's full change list", required: false, default: false }
+  }
+});
+var listCommand = defineCommand({
+  meta: { name: "list", description: "List other Sessions on this account, newest first." },
+  args: {
+    status: { type: "string", description: "Filter: active|archived|all (default: all)", required: false },
+    limit: { type: "string", description: "Max Sessions (1-100, default 20)", required: false },
+    full: { type: "boolean", description: "Include each Session's full change list", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = {};
+      if (args.status) {
+        if (!STATUS_GROUPS.includes(args.status)) {
+          throw new Error(`--status must be one of: ${STATUS_GROUPS.join("|")}`);
+        }
+        body.status = args.status;
+      }
+      const limit = parseBoundedInt(args.limit, "limit", 1, 100);
+      if (limit !== void 0) {
+        body.limit = limit;
+      }
+      if (args.full) {
+        body.full = true;
+      }
+      const selfChatId = getEnv().BAKER_CHAT_ID;
+      if (selfChatId) {
+        body.excludeChatId = selfChatId;
+      }
+      const response = await apiPost("/api/chats/list", body);
+      writeJson({
+        ...response,
+        meta: { count: response.data.chats.length },
+        ...response.data.chats.length === 0 ? { hints: ["No Sessions matched. Widen with --status all or a larger --limit."] } : {
+          hints: [
+            "Drill in: `baker chats view <id>` for outputs, `chats transcript <id>` for the conversation, `chats diff <id>` for the real file changes."
+          ]
+        }
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+registerSchema({
+  command: "chats.view",
+  description: "Inspect one Session's FULL picture of what it changed \u2014 the unified `effects`: git content (landings, creatives, flows, knowledge, brand), plus DB-only effects that never touch the repo \u2014 Actions, Scheduled agents, Tags, Tag Manager, Google Analytics, ad-platform writes, the funnel (`funnel`: which steps it added, changed or removed, and which ways in it added or removed in `triggersAdded`/`triggersRemoved`), what counts as a conversion (`conversions`), conversion sends, event sources, and every other staged or already-applied change (`otherChanges`: A/B tests, recipes, library images) \u2014 each resolved to real detail (names, descriptions, priorities, tag types, ad operations) and, once published, its `outcome`. Also `publish` (what each external surface actually did, with the provider's own error), `activity` (the chat's own timeline: status changes, publish start/fail, workspace recoveries, timeouts), `usage` (per-thread cost and the Session's token totals), the kickoff (how it was asked), threads, and commits. Effects are `staged` (in-progress draft) or applied. A completed Session is NOT proof its external changes landed \u2014 read `publish`. Use after `baker chats list` to decide whether to reuse it. Read-only.",
+  args: {
+    id: { type: "positional", description: "The Session id (from `baker chats list`)", required: true },
+    full: {
+      type: "boolean",
+      description: "Untruncated effect lists and full activity metadata (compact caps each list at 25)",
+      required: false,
+      default: false
+    }
+  }
+});
+var viewCommand = defineCommand({
+  meta: {
+    name: "view",
+    description: "Inspect one Session's full effects \u2014 git content + actions/tags/ads, kickoff, commits."
+  },
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    full: { type: "boolean", description: "Include full detail", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const response = await apiPost("/api/chats/view", {
+        chatId: args.id,
+        ...args.full ? { full: true } : {}
+      });
+      const hints = response.data.publish ? publishHints(response.data.publish) : [];
+      if (response.data.diffAvailable) {
+        hints.push("See the real file-level diff of the git content with `baker chats diff <id> --full`.");
+      } else if (response.data.status === "in_progress" || response.data.status === "publishing") {
+        hints.push(
+          "This Session is still in progress \u2014 read its current file changes with `baker chats diff <id> --live`."
+        );
+      }
+      hints.push("Read the conversation with `baker chats transcript <id>`.");
+      writeJson({ ...response, hints });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+registerSchema({
+  command: "chats.transcript",
+  description: "Read another Session's conversation (user + agent turns), most-recent first-capped. Use to see exactly how a past request was phrased and iterated before replaying it for a new goal. Compact truncates long messages; add --full for verbatim text. Read-only.",
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    limit: { type: "string", description: "Max messages to return, 1-1000 (default: 100)", required: false },
+    full: {
+      type: "boolean",
+      description: "Return verbatim (untruncated) message text",
+      required: false,
+      default: false
+    }
+  }
+});
+var transcriptCommand = defineCommand({
+  meta: { name: "transcript", description: "Read another Session's conversation." },
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    limit: { type: "string", description: "Max messages (1-1000, default 100)", required: false },
+    full: { type: "boolean", description: "Verbatim message text", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = { chatId: args.id };
+      const limit = parseBoundedInt(args.limit, "limit", 1, 1e3);
+      if (limit !== void 0) {
+        body.limit = limit;
+      }
+      if (args.full) {
+        body.full = true;
+      }
+      const response = await apiPost("/api/chats/transcript", body);
+      writeJson({
+        ...response,
+        meta: { count: response.data.entries.length },
+        ...response.data.truncated ? { hints: ["Older messages were dropped to fit --limit. Raise --limit to see more."] } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+registerSchema({
+  command: "chats.diff",
+  description: "See the real file-level changes a Session made (landings, creatives, brand, flows, knowledge). Published Sessions read from git; for an in-progress (unpublished) Session pass --live to read its changes straight from its running workspace. Without --live, an unpublished Session returns available:false \u2014 use `baker chats view` for the staged summary. Compact lists changed files with +/- counts; add --full for the actual diff text. Read-only.",
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    surface: {
+      type: "string",
+      description: "Filter to one surface: knowledge|company|brand|landings|flows|creatives",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Include the unified-diff patch text per file",
+      required: false,
+      default: false
+    },
+    live: {
+      type: "boolean",
+      description: "For an in-progress Session, read its changes from the live workspace (slower; resumes the paused Runtime). Ignored for published Sessions.",
+      required: false,
+      default: false
+    }
+  }
+});
+var diffCommand = defineCommand({
+  meta: { name: "diff", description: "See a published Session's real file-level changes." },
+  args: {
+    id: { type: "positional", description: "The Session id", required: true },
+    surface: {
+      type: "string",
+      description: "Filter: knowledge|company|brand|landings|flows|creatives",
+      required: false
+    },
+    full: { type: "boolean", description: "Include the diff patch text per file", required: false, default: false },
+    live: {
+      type: "boolean",
+      description: "Read an in-progress Session's changes from its live workspace (slower)",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = { chatId: args.id };
+      if (args.surface) {
+        if (!REPO_SURFACES.includes(args.surface)) {
+          throw new Error(`--surface must be one of: ${REPO_SURFACES.join("|")}`);
+        }
+        body.surface = args.surface;
+      }
+      if (args.full) {
+        body.full = true;
+      }
+      if (args.live) {
+        body.live = true;
+      }
+      const response = await apiPost("/api/chats/diff", body);
+      writeJson({
+        ...response,
+        meta: { count: response.data.files.length },
+        ...!response.data.available && response.data.reason ? { hints: [response.data.reason] } : {},
+        ...response.data.available && !args.full && response.data.files.length > 0 ? { hints: ["Add --full to read the actual diff text for each file."] } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var chatsCommand = defineCommand({
+  meta: {
+    name: "chats",
+    description: `Inspect other Sessions on this account (read-only): list them, view what they produced, read their conversation, and see their real file changes \u2014 so you can reuse past work for a new goal.
+Full guide: __tooling__/docs/tools/baker/chats.md`
+  },
+  subCommands: {
+    list: listCommand,
+    view: viewCommand,
+    transcript: transcriptCommand,
+    diff: diffCommand
+  }
+});
+export {
+  chatsCommand
+};
+//# sourceMappingURL=chats-EG6UCN45.js.map

package/dist/check-BC2KFBQM.js

@@ -0,0 +1,107 @@
+import {
+  readAdWords,
+  ruleRefusal
+} from "./chunk-ZQW6UZQC.js";
+import "./chunk-EIBWWYBK.js";
+import "./chunk-UTFSUMLU.js";
+import {
+  readAllRules
+} from "./chunk-XH7TGLJC.js";
+import {
+  ruleTells
+} from "./chunk-D4U72EIE.js";
+import "./chunk-32GFGVW2.js";
+import "./chunk-K6HH2KF3.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-M7MLFR2S.js";
+import "./chunk-ZRAZBHTG.js";
+import {
+  selectRules
+} from "./chunk-GXDFLDFK.js";
+import "./chunk-F3CZFUXZ.js";
+import {
+  marketFromCompanyDoc
+} from "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-H4DBWD3O.js";
+import "./chunk-WTLNH34U.js";
+import "./chunk-AQ2XSUIG.js";
+import "./chunk-WCJ3JTLF.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-4U7HXXSA.js";
+import "./chunk-V6AAOAMM.js";
+import "./chunk-GGUQP6KI.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-L55PHMSR.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/check.ts
+import { readdir, readFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+var DESCRIPTION = `Read every creative already made against the company's rules as they stand now: which ads say words a rule bans, or leave out words a rule requires. Run it after adding a rule (\`baker creatives rules add\`); nothing is re-rendered or marked stale, so ask the person which ads to correct.
+Start here: baker creatives check
+  baker creatives check --slug mba-ia-online   # one creative`;
+var ARGS = {
+  slug: { type: "string", description: "One creative (src/creatives/<slug>/); left out, every one", required: false }
+};
+registerSchema({ command: "creatives.check", description: DESCRIPTION, args: ARGS });
+function checkCreatives(ads, rules, companyLanguage) {
+  const breaking = ads.flatMap(({ slug, ad }) => {
+    const held = selectRules(
+      rules,
+      {
+        kind: ad.kind,
+        ...ad.product ? { product: ad.product } : {},
+        ...ad.platform ? { platform: ad.platform } : {},
+        ...ad.platforms ? { platforms: ad.platforms } : {}
+      },
+      ad.waived
+    );
+    const refusal = ruleRefusal(ruleTells(ad.lines, held, ad.language ?? companyLanguage));
+    return refusal ? [{ creative: slug, broken: refusal.problems }] : [];
+  });
+  return { checked: ads.length, breaking };
+}
+async function readAds(root, slug) {
+  const dir = path.join(root, "src", "creatives");
+  const slugs = slug ? [slug] : (await readdir(dir, { withFileTypes: true }).catch(() => [])).filter((e) => e.isDirectory() && !e.name.startsWith("_")).map((e) => e.name).sort();
+  const ads = await Promise.all(slugs.map(async (s) => ({ slug: s, ad: await readAdWords(path.join(dir, s)) })));
+  return ads.flatMap(({ slug: s, ad }) => ad ? [{ slug: s, ad }] : []);
+}
+var checkCommand = defineCommand({
+  meta: { name: "check", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const slug = typeof args.slug === "string" && args.slug ? args.slug : void 0;
+    const [ads, rules, companyDoc] = await Promise.all([
+      readAds(root, slug),
+      readAllRules(root),
+      readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => null)
+    ]);
+    const report = checkCreatives(ads, rules, marketFromCompanyDoc(companyDoc)?.language);
+    writeJson({
+      ok: true,
+      data: report,
+      hints: report.breaking.length > 0 ? [
+        `${report.breaking.length} of ${report.checked} ads break a rule now in force. Tell the person which, and correct only the ones they want: edit the words in that ad's prompt.json and run it again, or waive the rule there if the person asked for those words.`
+      ] : [`None of the ${report.checked} ads breaks a wording rule now in force.`]
+    });
+  }
+});
+export {
+  checkCommand,
+  checkCreatives
+};
+//# sourceMappingURL=check-BC2KFBQM.js.map

package/dist/chunk-24E77GI6.js

@@ -0,0 +1,91 @@
+import {
+  definitionPlatformOf,
+  parseDefinitionDelivery,
+  resolveDelivery,
+  resolveFormatList
+} from "./chunk-OXOC6TJC.js";
+import {
+  AD_PLACEMENTS
+} from "./chunk-F3CZFUXZ.js";
+import {
+  CAPABILITY_SURFACES
+} from "./chunk-NSBNIPIW.js";
+import {
+  apiPost
+} from "./chunk-4U7HXXSA.js";
+
+// src/commands/canvas/scaffold-delivery.ts
+var flagText = (value) => typeof value === "string" || typeof value === "number" ? String(value).trim() || void 0 : void 0;
+function deliveryInputOf(flags, definition, idea) {
+  const platformsFlag = flagText(flags.platforms);
+  const legacyPlatform = flagText(flags.platform);
+  const legacyPlacements = flagText(flags.placements);
+  const aspect = flagText(flags.aspect);
+  const formatsFlag = flagText(flags.formats);
+  const targetAdSet = flagText(flags["target-adset"]);
+  return {
+    ...platformsFlag ? { platformsFlag } : {},
+    ...legacyPlatform ? { legacyPlatform } : {},
+    ...legacyPlacements ? { legacyPlacements } : {},
+    ...aspect ? { aspect } : {},
+    ...formatsFlag ? { formatsFlag } : {},
+    ...idea && idea.length > 0 ? { idea } : {},
+    definition,
+    ...targetAdSet ? { targetAdSet } : {}
+  };
+}
+function namesDelivery(flags) {
+  return [flags.platforms, flags.platform, flags.placements, flags.formats].some((f) => flagText(f) !== void 0);
+}
+var SURFACE_PLATFORMS = {
+  "meta-ads": "meta",
+  "linkedin-ads": "linkedin",
+  "google-ads": "google_demandgen",
+  "x-ads": "x",
+  "chatgpt-ads": "chatgpt"
+};
+async function connectedAdPlatforms() {
+  try {
+    const response = await apiPost("/api/capabilities", {}, { timeoutMs: 15e3 });
+    return response.data.surfaces.filter((s) => s.connected && CAPABILITY_SURFACES.includes(s.surface)).flatMap((s) => SURFACE_PLATFORMS[s.surface] ? [SURFACE_PLATFORMS[s.surface]] : []);
+  } catch {
+    return [];
+  }
+}
+async function scaffoldDelivery(flags, definitionText, idea) {
+  const definition = definitionText === null ? null : parseDefinitionDelivery(definitionText);
+  const input = deliveryInputOf(flags, definition, idea);
+  const resolved = resolveDelivery(input);
+  if (resolved.ok || resolved.error.code !== "platform_required") return resolved;
+  return resolveDelivery({ ...input, connected: await connectedAdPlatforms() });
+}
+function deliveryDefinitionFields(delivery) {
+  const platforms = delivery.platforms.map((p) => p.trim());
+  return {
+    // The collection names whole platforms; a placement named alone records its platform.
+    platforms: [...new Set(platforms.map(platformOfName))],
+    platform: definitionPlatformOf(platforms[0] ?? ""),
+    formats: resolveFormatList(delivery.formats)
+  };
+}
+function platformOfName(name) {
+  return AD_PLACEMENTS.find((p) => p.id === name)?.platform ?? name;
+}
+function deliveryNote(delivery, renderRatio) {
+  const from = {
+    flag: "as asked",
+    idea: "from the idea",
+    definition: "from _definition.md",
+    legacy_definition: "from _definition.md's platform",
+    adset: "from its Meta ad set"
+  };
+  return `Made for ${delivery.platforms.join(", ")} (${from[delivery.source]}): delivers ${delivery.formats.join(", ")}, the ${delivery.lead} designed first (rendered at ${renderRatio}) and every other size re-laid out from it.`;
+}
+
+export {
+  namesDelivery,
+  scaffoldDelivery,
+  deliveryDefinitionFields,
+  deliveryNote
+};
+//# sourceMappingURL=chunk-24E77GI6.js.map

package/dist/chunk-2FL7NBPT.js

@@ -0,0 +1,45 @@
+import {
+  ANALYTICS_BUSY_FIX,
+  isAnalyticsBusy
+} from "./chunk-PILLZPNC.js";
+import {
+  ApiError
+} from "./chunk-4U7HXXSA.js";
+
+// src/commands/analytics/errorEnvelope.ts
+import { z } from "zod";
+function analyticsErrorEnvelope(err) {
+  if (err instanceof ApiError) {
+    return isAnalyticsBusy(err.message) ? { code: err.code, message: err.message, fix: ANALYTICS_BUSY_FIX } : { code: err.code, message: err.message };
+  }
+  return { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" };
+}
+function requestErrorEnvelope(err, correction, correctsLocalInput) {
+  if (err instanceof z.ZodError || err instanceof SyntaxError) {
+    const message = err instanceof z.ZodError ? z.prettifyError(err) : err.message;
+    return { code: "VALIDATION_ERROR", message, ...correctsLocalInput ? { fix: correction } : {} };
+  }
+  const envelope = analyticsErrorEnvelope(err);
+  return envelope.code === "VALIDATION_ERROR" ? { ...envelope, fix: correction } : envelope;
+}
+function questionnaireErrorEnvelope(err) {
+  return requestErrorEnvelope(
+    err,
+    "Check baker analytics plan --full for missing app events. Resolve the named contract issue or narrow the observation window; never infer abandonment from completion totals.",
+    false
+  );
+}
+function trackingPlanErrorEnvelope(err) {
+  return requestErrorEnvelope(
+    err,
+    "Read baker analytics plan --full and baker tag-manager draft list to see what is prepared. Correct the request and repeat; do not publish until every requested installation is staged.",
+    true
+  );
+}
+
+export {
+  analyticsErrorEnvelope,
+  questionnaireErrorEnvelope,
+  trackingPlanErrorEnvelope
+};
+//# sourceMappingURL=chunk-2FL7NBPT.js.map