@koda-sl/baker-cli 0.537.0 → 0.538.0-dev.fc2958a1d

package/dist/chats-5BNHZWO7.js

@@ -0,0 +1,384 @@
+import {
+  failApi
+} from "./chunk-XBMZNFN7.js";
+import {
+  CHAT_IMPORT_SURFACES
+} from "./chunk-XXS6SUVM.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-BNO3EFGR.js";
+import {
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import {
+  getEnv,
+  requireChatId
+} from "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.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 IMPORT_DESCRIPTION = `Move what another open chat has staged into this chat, in one call \u2014 and out of that chat, so publishing both can never apply anything twice.
+
+Start here when the user wants another chat's unpublished work brought into this one ("bring over",
+"merge the two chats", "include what the other chat prepared"):
+  baker chats import --from-chat <chat-id>
+  baker chats import --from-chat <chat-id> --only meta-ads,tasks     # only these surfaces
+
+It moves every surface exactly as staged: ads (Google, Meta, LinkedIn, X, ChatGPT), Shopify, Tag Manager,
+Google Analytics, tracking tags, Tasks, scheduled agents, ActiveCampaign, site settings, ad goals, the funnel,
+conversions, conversion sends, event sources and lead routes. When both chats change the same thing, nothing
+moves and the refusal names each clash \u2014 ask the user which version wins. What the other chat changed in
+files (Knowledge, pages, Forms), and what depends on those files, stays there; the result says what and why.
+A change moved here cannot go back: to leave one behind, ask the user first and use --only (Google Ads alone
+can pick single changes: \`baker ads google draft import --from-chat <id> --refs|--exclude\`).
+Find chat ids with \`baker chats list\`; see what one staged with \`baker chats view <id>\`.`;
+registerSchema({
+  command: "chats.import",
+  description: IMPORT_DESCRIPTION,
+  args: {
+    "from-chat": { type: "string", description: "The other open chat whose staged changes move here", required: true },
+    only: {
+      type: "string",
+      description: `Comma-separated surfaces to move (default: all): ${CHAT_IMPORT_SURFACES.join(", ")}`,
+      required: false
+    }
+  }
+});
+function importHints(data) {
+  const hints = [];
+  const moved = data.surfaces.reduce((sum, surface) => sum + surface.moved, 0);
+  const stayed = data.surfaces.filter((surface) => surface.left);
+  if (moved === 0 && stayed.length === 0) {
+    hints.push(`Chat ${data.fromChatId} had no unpublished changes staged, so nothing moved.`);
+  }
+  for (const surface of stayed) {
+    hints.push(
+      `${surface.left?.count ? `${surface.left.count} ` : ""}${surface.surface} change(s) stayed in chat ${data.fromChatId}: ${surface.left?.reason}`
+    );
+  }
+  if (data.filesStayed > 0) {
+    hints.push(
+      `Chat ${data.fromChatId} also changed ${data.filesStayed} file(s) (Knowledge, pages, Forms\u2026), which never move. Read them with \`baker chats diff ${data.fromChatId} --live --full\` and make the same changes here if the user wants them.`
+    );
+  }
+  if (moved > 0) {
+    hints.push(
+      "The moved changes are this chat's now and publish with it; the other chat no longer holds them. Review them with each surface's `draft list` (and `baker ads google draft validate` when Google Ads changes moved)."
+    );
+  }
+  if (moved > 0 && stayed.length === 0) {
+    hints.push(
+      "Nothing staged stayed in the other chat. Never tell the user to discard it for this: its other work is still there."
+    );
+  }
+  return hints;
+}
+function onlyFlag(value) {
+  if (typeof value !== "string") return {};
+  const named = value.split(",").map((surface) => surface.trim()).filter((surface) => surface.length > 0);
+  if (named.length === 0) return { refusal: "--only names no surface" };
+  const unknown = named.filter((surface) => !CHAT_IMPORT_SURFACES.includes(surface));
+  if (unknown.length > 0) return { refusal: `--only names ${unknown.join(", ")}, which is not a surface` };
+  return { surfaces: named };
+}
+function refuse(message, fix) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message, fix } });
+  process.exit(1);
+}
+var importCommand = defineCommand({
+  meta: { name: "import", description: IMPORT_DESCRIPTION },
+  args: {
+    "from-chat": { type: "string", description: "The other open chat whose staged changes move here" },
+    only: { type: "string", description: "Comma-separated surfaces to move (default: all)" }
+  },
+  run: async ({ args }) => {
+    const fromChatId = typeof args["from-chat"] === "string" ? args["from-chat"].trim() : "";
+    if (!fromChatId) {
+      refuse(
+        "--from-chat is required",
+        "Name the other chat: baker chats import --from-chat <chat-id> (ids from `baker chats list`)."
+      );
+    }
+    const only = onlyFlag(args.only);
+    if ("refusal" in only) {
+      refuse(
+        only.refusal,
+        `Name surfaces from: ${CHAT_IMPORT_SURFACES.join(", ")} \u2014 or leave --only off to move them all.`
+      );
+    }
+    try {
+      const response = await apiPost("/api/chats/import", {
+        chatId: requireChatId(),
+        fromChatId,
+        ...only.surfaces ? { surfaces: only.surfaces } : {}
+      });
+      writeJson({ ...response, hints: importHints(response.data) });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var chatsCommand = defineCommand({
+  meta: {
+    name: "chats",
+    description: `Inspect other Sessions on this account: 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. \`import --from-chat <id>\` moves another open Session's staged changes into this one.
+Full guide: __tooling__/docs/tools/baker/chats.md`
+  },
+  subCommands: {
+    list: listCommand,
+    view: viewCommand,
+    transcript: transcriptCommand,
+    diff: diffCommand,
+    import: importCommand
+  }
+});
+export {
+  chatsCommand
+};
+//# sourceMappingURL=chats-5BNHZWO7.js.map

package/dist/check-ESD3QPIZ.js

@@ -0,0 +1,107 @@
+import {
+  readAdWords,
+  ruleRefusal
+} from "./chunk-BUXPBPAP.js";
+import "./chunk-RSKU45CU.js";
+import "./chunk-LXV2U4MI.js";
+import {
+  readAllRules
+} from "./chunk-5TWI6FFY.js";
+import {
+  ruleTells
+} from "./chunk-YAX5CGUY.js";
+import "./chunk-ZPHHJPDG.js";
+import "./chunk-W3PJ7V4W.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-CM2LECNX.js";
+import "./chunk-2OCUXPWT.js";
+import {
+  selectRules
+} from "./chunk-KAUW3OFC.js";
+import "./chunk-F3CZFUXZ.js";
+import {
+  marketFromCompanyDoc
+} from "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-ZPF253G5.js";
+import "./chunk-AXSSATJW.js";
+import "./chunk-DNRXEP4A.js";
+import "./chunk-OYYAR5TD.js";
+import "./chunk-XXS6SUVM.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-BNO3EFGR.js";
+import "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.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-ESD3QPIZ.js.map