@koda-sl/baker-cli 0.449.0 → 0.451.0-dev.b2a4eba2b

package/dist/add-OBRA6W5Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/flows/add.ts"],"sourcesContent":["/**\n * `add-node` and `add-side-effect`: emit a valid skeleton and splice it in.\n *\n * The point is not to save typing — it is that the skeleton is right. A node\n * needs a fresh UUID, an explicit `condition: null`, the correct `nodeData`\n * discriminator, and — for a widget — `form.external: null` rather than an\n * invented resource. A side effect needs `encryptedConfig: null` and no\n * `oauthProviderId` key at all. Every one of those is a rule the flow-builder\n * skill used to spend prose on, and each was a real defect when got wrong.\n *\n * Deliberately scoped to creating the skeleton. Copy, conditions, autofill and\n * the `ai` field stay hand-edited: they are judgement, and a flag-based API for\n * them would be worse than JSON.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { type FlowConfigStatus, flowCatalogEntry, flowCatalogTypes, flowNodeTriggers } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport {\n  flowDataPath,\n  isUsableStepNameKey,\n  readFlowTree,\n  requestFlowInputCall,\n  stepNameKey,\n  walkNodes,\n  writeFlowTree,\n} from \"./shared.ts\";\n\ntype AnyRecord = Record<string, unknown>;\n\nfunction unknownType(kind: \"node\" | \"side-effect\", type: string): never {\n  writeJson({\n    ok: false,\n    error: {\n      code: \"VALIDATION_ERROR\",\n      message: `No ${kind} type \"${type}\".`,\n      fix: `Known types: ${flowCatalogTypes(kind).join(\", \")}. See: baker flows schema ${kind}`,\n    },\n  });\n  process.exit(1);\n}\n\n/** Replace the catalog's `<placeholder>` strings with real values where we have them. */\nfunction concrete(skeleton: AnyRecord, replacements: Record<string, unknown>): AnyRecord {\n  return { ...structuredClone(skeleton), ...replacements };\n}\n\n/**\n * Whether this name can be a step in this form, and why not when it cannot.\n *\n * Both answers are about the same fact: the name becomes a constant in the\n * form's generated `_query.ts` (`export const <KEY> = \"<node id>\";`), and\n * `flow-typed.mjs` writes it without checking either that it parses or that no\n * other step already produced it. So both failures land on a generated file\n * rather than on the name that caused them — one as a syntax error, one as\n * `Duplicate flow node name` — and `_query.ts` stops regenerating for the whole\n * form. A name is minted once, here, which makes here the only cheap place to\n * say so.\n *\n * Returns `null` when the name is fine.\n */\nexport function stepNameRefusal(nodes: readonly AnyRecord[], name: string): { message: string; fix: string } | null {\n  const key = stepNameKey(name);\n  if (!isUsableStepNameKey(key)) {\n    return {\n      message: `\"${name}\" cannot be a step name: it becomes the constant \\`${key || \"(empty)\"}\\`, which is not a valid identifier.`,\n      fix: 'A step name becomes `export const <NAME> = …` in the form\\'s generated code, so it must start with a letter and hold only letters, digits, spaces and dashes. Try \"Your Details\" rather than \"1. Your details\".',\n    };\n  }\n  const clash = nodes.find((node) => typeof node.name === \"string\" && stepNameKey(node.name) === key);\n  if (!clash) return null;\n  return {\n    message: `This form already has a step named \"${clash.name}\", which collides with \"${name}\".`,\n    fix: `Both become the constant \\`${key}\\`, and the form's generated code cannot hold it twice. Pick a name that differs by more than case, spacing or punctuation.`,\n  };\n}\n\nregisterSchema({\n  command: \"flows.add-node\",\n  description:\n    \"Add a step to a form with a valid skeleton — fresh UUID, explicit condition, correct nodeData discriminator, and form.external:null for a widget. Author its copy and conditions afterwards by editing _data.json.\",\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    type: { type: \"string\", description: \"Node type (see: baker flows schema node)\", required: true },\n    name: { type: \"string\", description: \"Step name — unique, Title Case\", required: true },\n    parent: { type: \"string\", description: \"Parent node id. Omit to append to the root's children.\", required: false },\n  },\n});\n\nexport const addNodeCommand = defineCommand({\n  meta: {\n    name: \"add-node\",\n    description:\n      'Add a step to a form, with the skeleton its type requires. Example: baker flows add-node contact --type customForm --name \"Contact Info\"',\n  },\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    type: { type: \"string\", description: \"Node type\", required: true },\n    name: { type: \"string\", description: \"Step name — unique, Title Case\", required: true },\n    parent: { type: \"string\", description: \"Parent node id (default: the root)\" },\n  },\n  run: ({ args }) => {\n    const slug = String(args.slug);\n    const type = String(args.type);\n    // Trimmed before anything reads it, because the generator does not trim:\n    // ` Contact Info ` becomes the constant `_CONTACT_INFO_`, which is legal,\n    // permanent, and not what anyone typed.\n    const name = String(args.name).trim();\n    const entry = flowCatalogEntry(\"node\", type) ?? unknownType(\"node\", type);\n\n    const tree = readFlowTree(slug);\n    const nodes = walkNodes(tree);\n\n    const refusal = stepNameRefusal(nodes, name);\n    if (refusal) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: refusal.message.replace(\"This form\", `\"${slug}\"`),\n          fix: refusal.fix,\n        },\n      });\n      process.exit(1);\n    }\n\n    const parent = args.parent ? nodes.find((node) => node.id === String(args.parent)) : tree;\n    if (!parent) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"NOT_FOUND\",\n          message: `No node with id \"${args.parent}\" in \"${slug}\".`,\n          fix: `Nodes in this form: ${nodes.map((node) => `${node.id} (${node.name})`).join(\", \")}`,\n        },\n      });\n      process.exit(1);\n    }\n\n    const node = concrete(entry.skeleton, { id: randomUUID(), name });\n    if (!Array.isArray(parent.children)) parent.children = [];\n    (parent.children as AnyRecord[]).push(node);\n    writeFlowTree(slug, tree);\n\n    writeJson({\n      ok: true,\n      data: { slug, nodeId: node.id, type, parentId: parent.id ?? null, path: flowDataPath(slug) },\n      hints: [\n        `Now fill in this step's \\`ai\\` field and its copy by editing ${flowDataPath(slug)}.`,\n        // Said on every step added, because the moment a Form's shape changes\n        // is the moment its outcome can move — and a Form nobody named an\n        // outcome for reports zero conversions rather than an error.\n        `Say what this Form counts before you finish: \\`baker analytics conversions --flow ${slug}\\` lists every ending already spelled as an event key, including this step's. Nothing in _data.json decides it.`,\n        ...(entry.owners?.[\"nodeData.form.external\"] === \"request_flow_input\"\n          ? [\n              `Pick this ${type} step's resource: ${requestFlowInputCall(slug, pendingItem(\"node\", String(node.id), type))}.`,\n            ]\n          : []),\n        ...(entry.gotcha ? [entry.gotcha] : []),\n      ],\n    });\n  },\n});\n\n/**\n * The `triggerId` a side effect on this step has to carry.\n *\n * This is the one field on a side effect that is decided by its STEP rather\n * than by its own type, and getting it wrong is silent in every direction:\n * `fireSideEffects` filters on `triggerId` equality, so a mismatch means the\n * side effect never runs — no error, no log, nothing half-written. Every\n * validator in the repo passes, because the file is valid; it just does nothing.\n *\n * Taking the skeleton's default was that failure. `SIDE_EFFECT_ENVELOPE` carries\n * `customForm.onFormSubmitted`, which is right for a `customForm` step and wrong\n * for the five widget types that raise an id of their own — so the command that\n * exists to emit a skeleton the agent cannot get wrong emitted a dead side\n * effect on any booking or embedded-form step.\n */\nexport type TriggerChoice = { ok: true; triggerId: string } | { ok: false; message: string; fix: string };\n\nexport function resolveTrigger(node: AnyRecord, requested: string | undefined): TriggerChoice {\n  const triggers = flowNodeTriggers(node.nodeData);\n  const where = `Step \"${String(node.name ?? node.id)}\"${triggers.type ? ` (a ${triggers.type} step)` : \"\"}`;\n  const raises = triggers.available.length > 0 ? `It raises: ${triggers.available.join(\", \")}.` : (triggers.why ?? \"\");\n  const no = (message: string, fix: string): TriggerChoice => ({ ok: false, message, fix });\n\n  // A node type the table does not cover is a table that has fallen behind, not\n  // a form that is wrong — so an explicit trigger is taken at its word there.\n  // Refusing instead would let a stale table reject a form the engine handles.\n  if (!triggers.known) {\n    return requested\n      ? { ok: true, triggerId: requested }\n      : no(`${where} is not a node type this command knows, so --trigger is required.`, triggers.why ?? \"\");\n  }\n\n  if (requested) {\n    return triggers.available.includes(requested)\n      ? { ok: true, triggerId: requested }\n      : no(\n          `${where} never raises \\`${requested}\\`, so a side effect carrying it would be written, pass every check, and never run.`,\n          raises,\n        );\n  }\n\n  return triggers.completion\n    ? { ok: true, triggerId: triggers.completion }\n    : no(`${where} has no trigger a side effect can answer.`, raises);\n}\n\n/**\n * The first `se-{type}-{n}` nobody is using.\n *\n * Counting the same-type side effects instead was wrong whenever the numbering\n * had a gap — a form holding `se-hubspotForm-1` and `se-hubspotForm-3`, or one\n * where `se-meta-1` was deleted and `se-meta-2` left behind. The count then\n * names an id that already exists and the command refuses, which is the one\n * outcome a skeleton-minting command should never produce for a form it can see\n * in full.\n */\nexport function freeSideEffectId(type: string, taken: ReadonlySet<string>): string {\n  for (let n = 1; ; n++) {\n    const candidate = `se-${type}-${n}`;\n    if (!taken.has(candidate)) return candidate;\n  }\n}\n\n/**\n * The pixel already reporting this step's moment to the same platform, if any.\n *\n * Only pixel types (those fed a tag ref) can double-count: two emails or two\n * CRMs on one step are a real need.\n */\nexport function sameTrackingSideEffect(node: AnyRecord, type: string, triggerId: string): AnyRecord | null {\n  if (flowCatalogEntry(\"side-effect\", type)?.owners?.tagIds !== \"tags\") return null;\n  const effects = Array.isArray(node.sideEffects) ? (node.sideEffects as unknown[]) : [];\n  for (const raw of effects) {\n    const effect = raw as AnyRecord | null;\n    if (effect?.type === type && effect.triggerId === triggerId) return effect;\n  }\n  return null;\n}\n\n/**\n * What a second pixel of one platform on one moment must not repeat.\n *\n * Two chats each wired GA4 `generate_lead` onto one submit and every lead\n * counted twice — but GA4 `sign_up` beside it is a second conversion, and the\n * skeleton added here has no event yet. So this warns instead of refusing;\n * the same event to the same tag is refused by the Form check at verify.\n */\nexport function secondPixelHint(node: AnyRecord, type: string, triggerId: string): string | null {\n  const already = sameTrackingSideEffect(node, type, triggerId);\n  if (!already) return null;\n  const event = typeof already.eventName === \"string\" ? ` with event \"${already.eventName}\"` : \"\";\n  return `\"${String(node.name ?? node.id)}\" already reports \\`${triggerId}\\` to ${type} as \"${String(already.id)}\"${event}. Give this one a different event; to change that conversion, edit \"${String(already.id)}\" and delete this one — the same event to the same tag counts every conversion twice.`;\n}\n\n/** The one row `requestFlowInputCall` needs, for an item this command just added unconfigured. */\nfunction pendingItem(\n  target: \"node\" | \"sideEffect\",\n  nodeId: string,\n  kind: string,\n  sideEffectId?: string,\n): FlowConfigStatus {\n  return {\n    target,\n    nodeId,\n    kind,\n    status: `${kind} — not configured`,\n    needsInput: true,\n    ...(sideEffectId ? { sideEffectId } : {}),\n  };\n}\n\nfunction configureHints(slug: string, nodeId: string, id: string, type: string, needsCard: boolean): string[] {\n  if (!needsCard) return [];\n  return [\n    `Configure it: ${requestFlowInputCall(slug, pendingItem(\"sideEffect\", nodeId, type, id))}. Read the destination off that call's result.`,\n  ];\n}\n\nregisterSchema({\n  command: \"flows.add-side-effect\",\n  description:\n    \"Add a side effect to a step with a valid skeleton — encryptedConfig:null for a CRM, a tagIds slot for a pixel, and no oauthProviderId key. Then set where it sends with `baker flows connect` (an email: --email/--subject, written by you); only a typed secret goes to request_flow_input.\",\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    node: { type: \"string\", description: \"Id of the step that fires it\", required: true },\n    type: { type: \"string\", description: \"Side-effect type (see: baker flows schema side-effect)\", required: true },\n    id: { type: \"string\", description: \"Side-effect id. Defaults to se-{type}-{n}.\", required: false },\n    trigger: {\n      type: \"string\",\n      description:\n        \"triggerId. Defaults to the moment the step named by --node completes, which is a different id per node type. Pass this only for a non-completion moment (a HubSpot form's onFormReady, a Calendly page view, one of several iframe events); an id the step never raises is refused.\",\n      required: false,\n    },\n  },\n});\n\nexport const addSideEffectCommand = defineCommand({\n  meta: {\n    name: \"add-side-effect\",\n    description:\n      \"Add a side effect to a step, with the skeleton its type requires. Example: baker flows add-side-effect contact --node <id> --type googleSpreadsheet\",\n  },\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    node: { type: \"string\", description: \"Id of the step that fires it\", required: true },\n    type: { type: \"string\", description: \"Side-effect type\", required: true },\n    id: { type: \"string\", description: \"Side-effect id (default se-{type}-{n})\" },\n    trigger: {\n      type: \"string\",\n      description: \"triggerId, for a non-completion moment. Default: whatever the step named by --node raises\",\n    },\n  },\n  run: ({ args }) => {\n    const slug = String(args.slug);\n    const type = String(args.type);\n    const entry = flowCatalogEntry(\"side-effect\", type) ?? unknownType(\"side-effect\", type);\n\n    const tree = readFlowTree(slug);\n    const nodes = walkNodes(tree);\n    const node = nodes.find((candidate) => candidate.id === String(args.node));\n    if (!node) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"NOT_FOUND\",\n          message: `No node with id \"${args.node}\" in \"${slug}\".`,\n          fix: `Nodes in this form: ${nodes.map((candidate) => `${candidate.id} (${candidate.name})`).join(\", \")}`,\n        },\n      });\n      process.exit(1);\n    }\n\n    if (!Array.isArray(node.sideEffects)) node.sideEffects = [];\n    const existing = node.sideEffects as AnyRecord[];\n    const takenIds = new Set(\n      nodes.flatMap((n) => ((n.sideEffects as AnyRecord[] | undefined) ?? []).map((se) => String(se?.id ?? \"\"))),\n    );\n    const id = args.id ? String(args.id) : freeSideEffectId(type, takenIds);\n\n    // Only an id the caller chose can still collide — the generated one is free\n    // by construction.\n    if (takenIds.has(id)) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: `\"${slug}\" already has a side effect with id \"${id}\".`,\n          fix: `Drop --id to be given a free one (${freeSideEffectId(type, takenIds)}), or pick another.`,\n        },\n      });\n      process.exit(1);\n    }\n\n    const trigger = resolveTrigger(node, args.trigger ? String(args.trigger) : undefined);\n    if (!trigger.ok) {\n      writeJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: trigger.message, ...(trigger.fix ? { fix: trigger.fix } : {}) },\n      });\n      process.exit(1);\n    }\n    const triggerId = trigger.triggerId;\n\n    const secondPixel = secondPixelHint(node, type, triggerId);\n\n    const sideEffect = concrete(entry.skeleton, { id, triggerId });\n    existing.push(sideEffect);\n    writeFlowTree(slug, tree);\n\n    const needsUser = Object.entries(entry.owners ?? {}).filter(([, owner]) => owner !== \"agent\");\n    writeJson({\n      ok: true,\n      data: { slug, nodeId: node.id, sideEffectId: id, type, triggerId, path: flowDataPath(slug) },\n      hints: [\n        `Fires on \\`${triggerId}\\` — the moment \"${String(node.name ?? node.id)}\" raises. A side effect only runs when its triggerId is the one its own step raises, so this is set from the step, never from the side-effect type.`,\n        // A pixel side effect is the thing most often mistaken for \"setting the\n        // conversion\". It tells the ad platform; it tells Baker nothing, and a\n        // Form can fire every pixel it has while every Baker report says it\n        // converted nobody.\n        ...(needsUser.some(([, owner]) => owner === \"tags\")\n          ? [\n              `This reports the conversion to ${type}. It does NOT make Baker count anything: what Baker counts is a named event, set with \\`baker analytics conversions --flow ${slug}\\`. Do both — they are two different systems asked the same question.`,\n            ]\n          : []),\n        ...(secondPixel ? [secondPixel] : []),\n        ...configureHints(\n          slug,\n          String(node.id),\n          id,\n          type,\n          needsUser.some(([, owner]) => owner === \"request_flow_input\" || owner === \"connect\"),\n        ),\n        ...(needsUser.some(([, owner]) => owner === \"tags\")\n          ? [\n              \"Fill `tagIds` with a real ref from `baker tags list`, or stage the tag first with the `tags` skill. Never invent one.\",\n            ]\n          : []),\n        ...(entry.gotcha ? [entry.gotcha] : []),\n      ],\n    });\n  },\n});\n"],"mappings":"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","names":["node"]}

package/dist/add-OSVUILLC.js

@@ -0,0 +1,104 @@
+import {
+  compactSource,
+  reportError,
+  reportInvalid
+} from "./chunk-5GRB5QUI.js";
+import {
+  testimonialSourceRefreshIntervalSchema,
+  testimonialSourceTypeSchema,
+  testimonialSourcesAddRequestSchema
+} from "./chunk-BAUSWB7O.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/add.ts
+import { defineCommand } from "citty";
+var SITES = testimonialSourceTypeSchema.options.join("|");
+registerSchema({
+  command: "testimonials.sources.add",
+  description: "Add a review page as a testimonial source \u2014 Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store or Google Play. Pass the page's link (it names its own site), or a business name for Google Maps. Its reviews (up to 700) are imported, tagged and made searchable in the background over the next minutes. Each imported review costs a little, so add only the client's own listings the user asked for. Applies immediately and shows on the chat as an already-applied change. Adding a listing that is already a source is a no-op that starts a fresh import.",
+  args: {
+    input: {
+      type: "string",
+      description: "The review page's link, or a business name (Google Maps only)",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: `Only to force a site: ${SITES}. A bare domain with trustpilot is that company's Trustpilot page.`,
+      required: false
+    },
+    every: {
+      type: "string",
+      description: `Auto-sync cadence: ${testimonialSourceRefreshIntervalSchema.options.join("|")} (default never)`,
+      required: false
+    }
+  }
+});
+function addSourceHints(input, { created, source }) {
+  const hints = [
+    created ? `Added ${source.label} on ${source.platformLabel}. Its reviews are importing in the background \u2014 they become searchable with \`baker testimonials search\` as each one is analysed, usually within a few minutes. Don't wait on them in this turn; check with \`baker testimonials sources list\`.` : `${source.label} on ${source.platformLabel} was already a source; a fresh import was started if one wasn't running.`
+  ];
+  if (created && source.platform === "google" && !/^https?:\/\/|\.[a-z]{2,}\//i.test(input.trim())) {
+    hints.push(
+      `Matched the name to ${source.label} on Google Maps (${source.pageUrl ?? "no link"}). If that is not the client's business, run \`baker testimonials sources remove ${source.id}\` at once and add the listing's Google Maps link instead.`
+    );
+  }
+  if (source.refreshInterval === "never") {
+    hints.push(
+      `Auto-sync is off. If the user wants new reviews to keep arriving: \`baker testimonials sources schedule ${source.id} --every monthly\`.`
+    );
+  }
+  return hints;
+}
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: `Add a review page as a testimonial source. Start here with the page's link; for Google Maps a business name also works.
+
+Examples:
+  baker testimonials sources add https://www.yelp.com/biz/acme-bakery-madrid
+  baker testimonials sources add https://www.g2.com/products/acme --every monthly
+  baker testimonials sources add "Acme Bakery Madrid"          # Google Maps, found by name
+  baker testimonials sources add acme.com --platform trustpilot`
+  },
+  args: {
+    input: { type: "positional", description: "Review page link, or a business name for Google Maps", required: true },
+    platform: { type: "string", description: `Force a site: ${SITES}`, required: false },
+    every: { type: "string", description: "Auto-sync: never|daily|weekly|monthly", required: false }
+  },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesAddRequestSchema.safeParse({
+      input: String(args.input ?? ""),
+      platform: args.platform ? String(args.platform).toLowerCase().replace(/[\s-]/g, "_") : void 0,
+      every: args.every ? String(args.every).toLowerCase() : void 0
+    });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/add", parsed.data, {
+        timeoutMs: 12e4
+      });
+      const hints = addSourceHints(parsed.data.input, data);
+      writeJson({ ok: true, data: { created: data.created, source: compactSource(data.source) }, hints });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  addCommand,
+  addSourceHints
+};
+//# sourceMappingURL=add-OSVUILLC.js.map

package/dist/ads-IVGQFY6E.js

@@ -0,0 +1,113 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-E7XNUDS5.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-VSA63D2N.js";
+import "./chunk-XNMSJP2X.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-KIGGMKAE.js";
+import {
+  apiGet
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/ads.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "adset-id": { type: "string", description: "Filter to one adset" },
+  "campaign-id": { type: "string", description: "Filter to one campaign" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  ...META_LIST_SHAPE_ARGS
+};
+registerMetaListSchema(
+  "ads",
+  "List ads in a Meta ad account, as a table by default: id, name, adset_id, campaign_id, effective_status, creative_id, issues (why an ad is WITH_ISSUES), created_time. Start here: baker ads meta ads --adset-id 6123. --fields takes dotted paths (e.g. id,tracking_specs); --full returns every field Meta sent; --output json returns the rows in the envelope.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List ads in a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta ads --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["adset-id"]) params["adset-id"] = args["adset-id"];
+      if (args["campaign-id"]) params["campaign-id"] = args["campaign-id"];
+      if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args["name-contains"]) params["name-contains"] = args["name-contains"];
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/ads", params);
+      const shaped = shapeMetaListRows("ads", data, args);
+      writeMetaListRows("ads", shaped, csvOrJson(args), statusFilterHints(data, effectiveStatus, "ads"));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var adsListCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: `List ads in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/retag).
+Defaults to ACTIVE only \u2014 pass --all-statuses to widen. Write subcommands stage ops on this chat's draft.
+
+The dashboard shows effective_status (e.g. WITH_ISSUES, PENDING_REVIEW, DISAPPROVED, ADSET_PAUSED), not status.
+
+Listings print a table by default: id, name, adset_id, campaign_id, effective_status, creative_id, issues
+(why an ad is WITH_ISSUES), created_time. --fields takes dotted paths (e.g. tracking_specs,
+preview_shareable_link); --full returns every field; --output json returns the rows as JSON.
+
+Examples:
+  baker ads meta ads --account-id act_123
+  baker ads meta ads --adset-id 6123
+  baker ads meta ads --account-id act_123 --all-statuses --name-contains octubre --fields id,name,adset_id,creative_id   \u2014 find one ad by name
+  baker ads meta ads --adset-id 6123 --fields id,name,preview_shareable_link
+  baker ads meta ads create --name "Ad 1" --adset meta_temp_as01 --creative meta_temp_cr01
+  baker ads meta ads pause 6123 --account-id act_123
+  baker ads meta ads retag 6123 --set "utm_medium=paid-social"      \u2014 fix tracking on a LIVE ad, keeping everything else`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adsCreateCommand),
+    update: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adsArchiveCommand),
+    delete: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adsDeleteCommand),
+    duplicate: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adsDuplicateCommand),
+    retag: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adsRetagCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  adsListCommand
+};
+//# sourceMappingURL=ads-IVGQFY6E.js.map

package/dist/ads-ODTIC6AO.js

@@ -0,0 +1,77 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-LHCOWIGI.js";
+import "./chunk-XNMSJP2X.js";
+import "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/ads.ts
+import { defineCommand } from "citty";
+var args = {
+  "ad-group-id": { type: "string", description: "Only this ad group's ads (adgrp_\u2026)", required: false },
+  full: { type: "boolean", description: "Return ChatGPT Ads' own ad objects", required: false }
+};
+registerSchema({
+  command: "ads.chatgpt.ads",
+  description: "Ads in the connected ChatGPT Ads account, or in one ad group: the card's title, body, image and destination, its review outcome and reason, and serving issues.",
+  args
+});
+function adHints(ads) {
+  const rejected = ads.filter((ad) => ad.review === "rejected");
+  return rejected.length > 0 ? [
+    `${rejected.length} ad(s) were rejected in review; reviewReason says why. Editing the creative sends it back to review.`
+  ] : [];
+}
+var adsListCommand = defineCommand({
+  meta: { name: "list", description: "ChatGPT Ads chat cards. Example: baker ads chatgpt ads --ad-group-id adgrp_123" },
+  args,
+  run: async ({ args: input }) => {
+    const params = {};
+    if (input["ad-group-id"]) {
+      params["ad-group-id"] = input["ad-group-id"];
+    }
+    if (input.full) {
+      params.full = "true";
+    }
+    await runChatgptListRead(
+      CHATGPT_ADS_REFERENCE.ads,
+      "/api/ads/chatgpt/ads",
+      params,
+      (ads) => input.full ? [] : adHints(ads)
+    );
+  }
+});
+var adsCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: `ChatGPT Ads ads (chat cards): copy, image, destination and review status \u2014 or stage a change that applies when the chat is published.
+
+Examples:
+  baker ads chatgpt ads --ad-group-id adgrp_123
+  baker ads chatgpt ads create --ad-group-id adgrp_123 --name "Card A" --title "\u2026" --body "\u2026" --target-url https://\u2026 --image-url https://\u2026
+  baker ads chatgpt ads update ad_123 --title "Solar with no upfront cost"
+  baker ads chatgpt ads pause ad_123`
+  },
+  subCommands: {
+    list: adsListCommand,
+    create: () => import("./ad-writes-XZEKXPP2.js").then((m) => m.adsCreateCommand),
+    update: () => import("./ad-writes-XZEKXPP2.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./ad-writes-XZEKXPP2.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./ad-writes-XZEKXPP2.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./ad-writes-XZEKXPP2.js").then((m) => m.adsArchiveCommand),
+    "create-product": () => import("./ad-writes-XZEKXPP2.js").then((m) => m.adsCreateProductCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args,
+  default: "list"
+});
+export {
+  adsCommand
+};
+//# sourceMappingURL=ads-ODTIC6AO.js.map

package/dist/ads-ULSDT6MZ.js

@@ -0,0 +1,40 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/index.ts
+import { defineCommand } from "citty";
+var adsCommand = defineCommand({
+  meta: {
+    name: "ads",
+    description: `Ad platform commands. Each platform exposes its own native command surface \u2014 no forced parity.
+
+Platforms:
+  google    \u2014 Google Ads (GAQL queries, keywords, accounts, ad library)
+  meta      \u2014 Meta Ads (campaigns, adsets, ads, insights, previews)
+  linkedin  \u2014 LinkedIn Ads (firmographic analytics \u2014 job-title \xD7 company \xD7 industry \xD7 seniority pivots)
+  x         \u2014 X (Twitter) Ads (campaigns, line items, promoted tweets, analytics)
+  chatgpt   \u2014 ChatGPT Ads (account, campaigns, ad groups, ads, insights \u2014 read-only)
+
+Examples:
+  baker ads google accounts
+  baker ads google query --preset campaign-performance --customer-id 1234567890
+  baker ads meta accounts
+  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE
+  baker ads meta insights --object act_123 --level ad --date-preset last_7d --fields impressions,spend,ctr
+  baker ads linkedin accounts
+  baker ads x accounts
+  baker ads x stats sync --preset campaign-engagement-7d --entity-ids abc,def
+  baker ads chatgpt insights --days 30 --granularity daily
+Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedin|x|chatgpt)`
+  },
+  subCommands: {
+    google: () => import("./google-LA42DKVM.js").then((m) => m.googleCommand),
+    meta: () => import("./meta-NJTTWKGW.js").then((m) => m.metaCommand),
+    linkedin: () => import("./linkedin-ZQNIUZCH.js").then((m) => m.linkedinCommand),
+    x: () => import("./x-E3PLB3NR.js").then((m) => m.xCommand),
+    chatgpt: () => import("./chatgpt-UDAIH7QY.js").then((m) => m.chatgptCommand)
+  }
+});
+export {
+  adsCommand
+};
+//# sourceMappingURL=ads-ULSDT6MZ.js.map

package/dist/adsets-3EW7RTJM.js

@@ -0,0 +1,176 @@
+import {
+  VIEWER_TABLE_COLUMNS,
+  adSetViewerRows,
+  audienceNamesOf,
+  flattenViewerRows,
+  readAudienceNames
+} from "./chunk-NFSLRRIE.js";
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-E7XNUDS5.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-VSA63D2N.js";
+import {
+  rememberedJev
+} from "./chunk-SGFJ4VXB.js";
+import {
+  writeAdsOutput
+} from "./chunk-XNMSJP2X.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-Z6JUXGJ3.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-IFD5LJWU.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-B6KFPCGF.js";
+import "./chunk-DIJBHIII.js";
+import "./chunk-CRX5XO4W.js";
+import "./chunk-VVS5TLDG.js";
+import {
+  apiGet
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/adsets.ts
+import path from "path";
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "campaign-id": { type: "string", description: "Filter to one campaign" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  audience: {
+    type: "boolean",
+    description: "Who each ad set reaches, instead of the compact row: a viewer per ad set \u2014 temperature (cold|warm|hot), what they already know (brand/offer/product), placements, and the reasons, read from its targeting, the account's audiences and the campaign objective. Start here before writing an ad for an ad set: baker ads meta adsets --campaign-id 6123 --audience --output json"
+  },
+  ...META_LIST_SHAPE_ARGS
+};
+async function readOrEmpty(path2, params, label, hints) {
+  try {
+    return await apiGet(path2, params);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "unknown error";
+    hints.push(`Could not read the account's ${label} (${message}); the viewer was read without them.`);
+    return [];
+  }
+}
+async function writeAdSetViewers(adSets, accountParams, format, hints) {
+  const [audiences, campaigns] = await Promise.all([
+    readOrEmpty("/api/ads/meta/audiences", accountParams, "audiences", hints),
+    readOrEmpty("/api/ads/meta/campaigns", accountParams, "campaigns", hints)
+  ]);
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  const cacheDir = path.join(root, "canvas", ".cache");
+  const spent = [];
+  const readName = await readAudienceNames(
+    audienceNamesOf(adSets, audiences),
+    rememberedJev(path.join(cacheDir, "audience-names.json"), (u) => spent.push(u))
+  );
+  await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+  const rows = adSetViewerRows(adSets, audiences, campaigns, readName);
+  if (rows.length > 0) {
+    hints.push(
+      `Write each ad for the viewer of the ad set it will run in, then record it in the creative's _definition.md: targetAdSet: "<ad set id>" and viewer: { temperature, knows, placements, source }.`
+    );
+  }
+  if (format === "md" || format === "csv") {
+    writeAdsOutput(flattenViewerRows(rows), format, [...VIEWER_TABLE_COLUMNS], hints);
+    return;
+  }
+  writeAdsOutput(rows, format, void 0, hints);
+}
+registerMetaListSchema(
+  "adsets",
+  "List ad sets in a Meta ad account, as a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event, bid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting is not in the compact row \u2014 ask for it with --fields id,name,targeting (or --full). --audience replaces the row with who each ad set reaches (a viewer: temperature, what they already know, placements, reasons) \u2014 read it before writing an ad for an ad set. Start here: baker ads meta adsets --campaign-id 6123 --all-statuses. --output json returns the rows in the envelope.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List ad sets in a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta adsets --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["campaign-id"]) params["campaign-id"] = args["campaign-id"];
+      if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args["name-contains"]) params["name-contains"] = args["name-contains"];
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/adsets", params);
+      if (args.audience) {
+        const hints = statusFilterHints(data, effectiveStatus, "ad sets");
+        const accountParams = { "account-id": accountId };
+        if (args["no-cache"]) accountParams["skip-cache"] = "true";
+        await writeAdSetViewers(data, accountParams, csvOrJson(args), hints);
+        return;
+      }
+      const shaped = shapeMetaListRows("adsets", data, args);
+      writeMetaListRows("adsets", shaped, csvOrJson(args), statusFilterHints(data, effectiveStatus, "ad sets"));
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var adsetsCommand = defineCommand({
+  meta: {
+    name: "adsets",
+    description: `List ad sets in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate).
+Defaults to ACTIVE only. Write subcommands stage ops on this chat's draft.
+
+Listings print a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event,
+bid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting
+is not in the compact row \u2014 ask for it with --fields (dotted paths) or --full. --output json returns the rows as JSON.
+
+Examples:
+  baker ads meta adsets --account-id act_123
+  baker ads meta adsets --campaign-id 6123456789
+  baker ads meta adsets --account-id act_123 --all-statuses --name-contains retargeting   \u2014 find one ad set by name
+  baker ads meta adsets --campaign-id 6123456789 --fields id,name,targeting.geo_locations
+  baker ads meta adsets --campaign-id 6123456789 --audience --output json   \u2014 who each ad set reaches (viewer per ad set)
+  baker ads meta adsets create --campaign meta_temp_ab12 --name "US 25-54" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --daily-budget 50 --targeting-file t.json`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adSetsCreateCommand),
+    update: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adSetsUpdateCommand),
+    pause: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adSetsPauseCommand),
+    resume: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adSetsResumeCommand),
+    archive: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adSetsArchiveCommand),
+    delete: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adSetsDeleteCommand),
+    duplicate: () => import("./write-commands-FRH4UWLN.js").then((m) => m.adSetsDuplicateCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  adsetsCommand
+};
+//# sourceMappingURL=adsets-3EW7RTJM.js.map