@koda-sl/baker-cli 0.458.0 → 0.459.0

package/dist/add-KREQCZ3B.js

@@ -0,0 +1,103 @@
+import {
+  compactSource,
+  reportError,
+  reportInvalid
+} from "./chunk-WNP25LQF.js";
+import {
+  testimonialSourceRefreshIntervalSchema,
+  testimonialSourceTypeSchema,
+  testimonialSourcesAddRequestSchema
+} from "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-USFTTDIO.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-KREQCZ3B.js.map

package/dist/add-KREQCZ3B.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/testimonials/sources/add.ts"],"sourcesContent":["import {\n  type TestimonialSourcesAddResponse,\n  testimonialSourceRefreshIntervalSchema,\n  testimonialSourcesAddRequestSchema,\n  testimonialSourceTypeSchema,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeJson } from \"../../../output.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { compactSource, reportError, reportInvalid } from \"./shared.ts\";\n\nconst SITES = testimonialSourceTypeSchema.options.join(\"|\");\n\nregisterSchema({\n  command: \"testimonials.sources.add\",\n  description:\n    \"Add a review page as a testimonial source — 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.\",\n  args: {\n    input: {\n      type: \"string\",\n      description: \"The review page's link, or a business name (Google Maps only)\",\n      required: true,\n    },\n    platform: {\n      type: \"string\",\n      description: `Only to force a site: ${SITES}. A bare domain with trustpilot is that company's Trustpilot page.`,\n      required: false,\n    },\n    every: {\n      type: \"string\",\n      description: `Auto-sync cadence: ${testimonialSourceRefreshIntervalSchema.options.join(\"|\")} (default never)`,\n      required: false,\n    },\n  },\n});\n\n/** What the agent should know after an add: that it runs on without it, and what to check. */\nexport function addSourceHints(input: string, { created, source }: TestimonialSourcesAddResponse): string[] {\n  const hints = [\n    created\n      ? `Added ${source.label} on ${source.platformLabel}. Its reviews are importing in the background — 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\\`.`\n      : `${source.label} on ${source.platformLabel} was already a source; a fresh import was started if one wasn't running.`,\n  ];\n  if (created && source.platform === \"google\" && !/^https?:\\/\\/|\\.[a-z]{2,}\\//i.test(input.trim())) {\n    hints.push(\n      `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.`,\n    );\n  }\n  if (source.refreshInterval === \"never\") {\n    hints.push(\n      `Auto-sync is off. If the user wants new reviews to keep arriving: \\`baker testimonials sources schedule ${source.id} --every monthly\\`.`,\n    );\n  }\n  return hints;\n}\n\nexport const addCommand = defineCommand({\n  meta: {\n    name: \"add\",\n    description: `Add a review page as a testimonial source. Start here with the page's link; for Google Maps a business name also works.\n\nExamples:\n  baker testimonials sources add https://www.yelp.com/biz/acme-bakery-madrid\n  baker testimonials sources add https://www.g2.com/products/acme --every monthly\n  baker testimonials sources add \"Acme Bakery Madrid\"          # Google Maps, found by name\n  baker testimonials sources add acme.com --platform trustpilot`,\n  },\n  args: {\n    input: { type: \"positional\", description: \"Review page link, or a business name for Google Maps\", required: true },\n    platform: { type: \"string\", description: `Force a site: ${SITES}`, required: false },\n    every: { type: \"string\", description: \"Auto-sync: never|daily|weekly|monthly\", required: false },\n  },\n  run: async ({ args }) => {\n    const parsed = testimonialSourcesAddRequestSchema.safeParse({\n      input: String(args.input ?? \"\"),\n      platform: args.platform ? String(args.platform).toLowerCase().replace(/[\\s-]/g, \"_\") : undefined,\n      every: args.every ? String(args.every).toLowerCase() : undefined,\n    });\n    if (!parsed.success) reportInvalid(parsed.error.issues[0]);\n\n    try {\n      const data = await apiPost<TestimonialSourcesAddResponse>(\"/api/testimonials/sources/add\", parsed.data, {\n        timeoutMs: 120_000,\n      });\n      const hints = addSourceHints(parsed.data.input, data);\n      writeJson({ ok: true, data: { created: data.created, source: compactSource(data.source) }, hints });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAMA,SAAS,qBAAqB;AAM9B,IAAM,QAAQ,4BAA4B,QAAQ,KAAK,GAAG;AAE1D,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa,yBAAyB,KAAK;AAAA,MAC3C,UAAU;AAAA,IACZ;AAAA,IACA,OAAO;AAAA,MACL,MAAM;AAAA,MACN,aAAa,sBAAsB,uCAAuC,QAAQ,KAAK,GAAG,CAAC;AAAA,MAC3F,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAGM,SAAS,eAAe,OAAe,EAAE,SAAS,OAAO,GAA4C;AAC1G,QAAM,QAAQ;AAAA,IACZ,UACI,SAAS,OAAO,KAAK,OAAO,OAAO,aAAa,2PAChD,GAAG,OAAO,KAAK,OAAO,OAAO,aAAa;AAAA,EAChD;AACA,MAAI,WAAW,OAAO,aAAa,YAAY,CAAC,8BAA8B,KAAK,MAAM,KAAK,CAAC,GAAG;AAChG,UAAM;AAAA,MACJ,uBAAuB,OAAO,KAAK,oBAAoB,OAAO,WAAW,SAAS,oFAAoF,OAAO,EAAE;AAAA,IACjL;AAAA,EACF;AACA,MAAI,OAAO,oBAAoB,SAAS;AACtC,UAAM;AAAA,MACJ,2GAA2G,OAAO,EAAE;AAAA,IACtH;AAAA,EACF;AACA,SAAO;AACT;AAEO,IAAM,aAAa,cAAc;AAAA,EACtC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOf;AAAA,EACA,MAAM;AAAA,IACJ,OAAO,EAAE,MAAM,cAAc,aAAa,wDAAwD,UAAU,KAAK;AAAA,IACjH,UAAU,EAAE,MAAM,UAAU,aAAa,iBAAiB,KAAK,IAAI,UAAU,MAAM;AAAA,IACnF,OAAO,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,EACjG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,mCAAmC,UAAU;AAAA,MAC1D,OAAO,OAAO,KAAK,SAAS,EAAE;AAAA,MAC9B,UAAU,KAAK,WAAW,OAAO,KAAK,QAAQ,EAAE,YAAY,EAAE,QAAQ,UAAU,GAAG,IAAI;AAAA,MACvF,OAAO,KAAK,QAAQ,OAAO,KAAK,KAAK,EAAE,YAAY,IAAI;AAAA,IACzD,CAAC;AACD,QAAI,CAAC,OAAO,QAAS,eAAc,OAAO,MAAM,OAAO,CAAC,CAAC;AAEzD,QAAI;AACF,YAAM,OAAO,MAAM,QAAuC,iCAAiC,OAAO,MAAM;AAAA,QACtG,WAAW;AAAA,MACb,CAAC;AACD,YAAM,QAAQ,eAAe,OAAO,KAAK,OAAO,IAAI;AACpD,gBAAU,EAAE,IAAI,MAAM,MAAM,EAAE,SAAS,KAAK,SAAS,QAAQ,cAAc,KAAK,MAAM,EAAE,GAAG,MAAM,CAAC;AAAA,IACpG,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/add-WFAYC64E.js

@@ -0,0 +1,301 @@
+import {
+  flowDataPath,
+  isUsableStepNameKey,
+  readFlowTree,
+  requestFlowInputCall,
+  stepNameKey,
+  walkNodes,
+  writeFlowTree
+} from "./chunk-IDORRX5W.js";
+import {
+  flowCatalogEntry,
+  flowCatalogTypes,
+  flowNodeTriggers
+} from "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-USFTTDIO.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/flows/add.ts
+import { randomUUID } from "crypto";
+import { defineCommand } from "citty";
+function unknownType(kind, type) {
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: `No ${kind} type "${type}".`,
+      fix: `Known types: ${flowCatalogTypes(kind).join(", ")}. See: baker flows schema ${kind}`
+    }
+  });
+  process.exit(1);
+}
+function concrete(skeleton, replacements) {
+  return { ...structuredClone(skeleton), ...replacements };
+}
+function stepNameRefusal(nodes, name) {
+  const key = stepNameKey(name);
+  if (!isUsableStepNameKey(key)) {
+    return {
+      message: `"${name}" cannot be a step name: it becomes the constant \`${key || "(empty)"}\`, which is not a valid identifier.`,
+      fix: 'A step name becomes `export const <NAME> = \u2026` 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".'
+    };
+  }
+  const clash = nodes.find((node) => typeof node.name === "string" && stepNameKey(node.name) === key);
+  if (!clash) return null;
+  return {
+    message: `This form already has a step named "${clash.name}", which collides with "${name}".`,
+    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.`
+  };
+}
+registerSchema({
+  command: "flows.add-node",
+  description: "Add a step to a form with a valid skeleton \u2014 fresh UUID, explicit condition, correct nodeData discriminator, and form.external:null for a widget. Author its copy and conditions afterwards by editing _data.json.",
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    type: { type: "string", description: "Node type (see: baker flows schema node)", required: true },
+    name: { type: "string", description: "Step name \u2014 unique, Title Case", required: true },
+    parent: { type: "string", description: "Parent node id. Omit to append to the root's children.", required: false }
+  }
+});
+var addNodeCommand = defineCommand({
+  meta: {
+    name: "add-node",
+    description: 'Add a step to a form, with the skeleton its type requires. Example: baker flows add-node contact --type customForm --name "Contact Info"'
+  },
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    type: { type: "string", description: "Node type", required: true },
+    name: { type: "string", description: "Step name \u2014 unique, Title Case", required: true },
+    parent: { type: "string", description: "Parent node id (default: the root)" }
+  },
+  run: ({ args }) => {
+    const slug = String(args.slug);
+    const type = String(args.type);
+    const name = String(args.name).trim();
+    const entry = flowCatalogEntry("node", type) ?? unknownType("node", type);
+    const tree = readFlowTree(slug);
+    const nodes = walkNodes(tree);
+    const refusal = stepNameRefusal(nodes, name);
+    if (refusal) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: refusal.message.replace("This form", `"${slug}"`),
+          fix: refusal.fix
+        }
+      });
+      process.exit(1);
+    }
+    const parent = args.parent ? nodes.find((node2) => node2.id === String(args.parent)) : tree;
+    if (!parent) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "NOT_FOUND",
+          message: `No node with id "${args.parent}" in "${slug}".`,
+          fix: `Nodes in this form: ${nodes.map((node2) => `${node2.id} (${node2.name})`).join(", ")}`
+        }
+      });
+      process.exit(1);
+    }
+    const node = concrete(entry.skeleton, { id: randomUUID(), name });
+    if (!Array.isArray(parent.children)) parent.children = [];
+    parent.children.push(node);
+    writeFlowTree(slug, tree);
+    writeJson({
+      ok: true,
+      data: { slug, nodeId: node.id, type, parentId: parent.id ?? null, path: flowDataPath(slug) },
+      hints: [
+        `Now fill in this step's \`ai\` field and its copy by editing ${flowDataPath(slug)}.`,
+        // Said on every step added, because the moment a Form's shape changes
+        // is the moment its outcome can move — and a Form nobody named an
+        // outcome for reports zero conversions rather than an error.
+        `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.`,
+        ...entry.owners?.["nodeData.form.external"] === "request_flow_input" ? [
+          `Pick this ${type} step's resource: ${requestFlowInputCall(slug, pendingItem("node", String(node.id), type))}.`
+        ] : [],
+        ...entry.gotcha ? [entry.gotcha] : []
+      ]
+    });
+  }
+});
+function resolveTrigger(node, requested) {
+  const triggers = flowNodeTriggers(node.nodeData);
+  const where = `Step "${String(node.name ?? node.id)}"${triggers.type ? ` (a ${triggers.type} step)` : ""}`;
+  const raises = triggers.available.length > 0 ? `It raises: ${triggers.available.join(", ")}.` : triggers.why ?? "";
+  const no = (message, fix) => ({ ok: false, message, fix });
+  if (!triggers.known) {
+    return requested ? { ok: true, triggerId: requested } : no(`${where} is not a node type this command knows, so --trigger is required.`, triggers.why ?? "");
+  }
+  if (requested) {
+    return triggers.available.includes(requested) ? { ok: true, triggerId: requested } : no(
+      `${where} never raises \`${requested}\`, so a side effect carrying it would be written, pass every check, and never run.`,
+      raises
+    );
+  }
+  return triggers.completion ? { ok: true, triggerId: triggers.completion } : no(`${where} has no trigger a side effect can answer.`, raises);
+}
+function freeSideEffectId(type, taken) {
+  for (let n = 1; ; n++) {
+    const candidate = `se-${type}-${n}`;
+    if (!taken.has(candidate)) return candidate;
+  }
+}
+function sameTrackingSideEffect(node, type, triggerId) {
+  if (flowCatalogEntry("side-effect", type)?.owners?.tagIds !== "tags") return null;
+  const effects = Array.isArray(node.sideEffects) ? node.sideEffects : [];
+  for (const raw of effects) {
+    const effect = raw;
+    if (effect?.type === type && effect.triggerId === triggerId) return effect;
+  }
+  return null;
+}
+function secondPixelHint(node, type, triggerId) {
+  const already = sameTrackingSideEffect(node, type, triggerId);
+  if (!already) return null;
+  const event = typeof already.eventName === "string" ? ` with event "${already.eventName}"` : "";
+  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 \u2014 the same event to the same tag counts every conversion twice.`;
+}
+function pendingItem(target, nodeId, kind, sideEffectId) {
+  return {
+    target,
+    nodeId,
+    kind,
+    status: `${kind} \u2014 not configured`,
+    needsInput: true,
+    ...sideEffectId ? { sideEffectId } : {}
+  };
+}
+function configureHints(slug, nodeId, id, type, needsCard) {
+  if (!needsCard) return [];
+  return [
+    `Configure it: ${requestFlowInputCall(slug, pendingItem("sideEffect", nodeId, type, id))}. Read the destination off that call's result.`
+  ];
+}
+registerSchema({
+  command: "flows.add-side-effect",
+  description: "Add a side effect to a step with a valid skeleton \u2014 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.",
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    node: { type: "string", description: "Id of the step that fires it", required: true },
+    type: { type: "string", description: "Side-effect type (see: baker flows schema side-effect)", required: true },
+    id: { type: "string", description: "Side-effect id. Defaults to se-{type}-{n}.", required: false },
+    trigger: {
+      type: "string",
+      description: "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.",
+      required: false
+    }
+  }
+});
+var addSideEffectCommand = defineCommand({
+  meta: {
+    name: "add-side-effect",
+    description: "Add a side effect to a step, with the skeleton its type requires. Example: baker flows add-side-effect contact --node <id> --type googleSpreadsheet"
+  },
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    node: { type: "string", description: "Id of the step that fires it", required: true },
+    type: { type: "string", description: "Side-effect type", required: true },
+    id: { type: "string", description: "Side-effect id (default se-{type}-{n})" },
+    trigger: {
+      type: "string",
+      description: "triggerId, for a non-completion moment. Default: whatever the step named by --node raises"
+    }
+  },
+  run: ({ args }) => {
+    const slug = String(args.slug);
+    const type = String(args.type);
+    const entry = flowCatalogEntry("side-effect", type) ?? unknownType("side-effect", type);
+    const tree = readFlowTree(slug);
+    const nodes = walkNodes(tree);
+    const node = nodes.find((candidate) => candidate.id === String(args.node));
+    if (!node) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "NOT_FOUND",
+          message: `No node with id "${args.node}" in "${slug}".`,
+          fix: `Nodes in this form: ${nodes.map((candidate) => `${candidate.id} (${candidate.name})`).join(", ")}`
+        }
+      });
+      process.exit(1);
+    }
+    if (!Array.isArray(node.sideEffects)) node.sideEffects = [];
+    const existing = node.sideEffects;
+    const takenIds = new Set(
+      nodes.flatMap((n) => (n.sideEffects ?? []).map((se) => String(se?.id ?? "")))
+    );
+    const id = args.id ? String(args.id) : freeSideEffectId(type, takenIds);
+    if (takenIds.has(id)) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: `"${slug}" already has a side effect with id "${id}".`,
+          fix: `Drop --id to be given a free one (${freeSideEffectId(type, takenIds)}), or pick another.`
+        }
+      });
+      process.exit(1);
+    }
+    const trigger = resolveTrigger(node, args.trigger ? String(args.trigger) : void 0);
+    if (!trigger.ok) {
+      writeJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: trigger.message, ...trigger.fix ? { fix: trigger.fix } : {} }
+      });
+      process.exit(1);
+    }
+    const triggerId = trigger.triggerId;
+    const secondPixel = secondPixelHint(node, type, triggerId);
+    const sideEffect = concrete(entry.skeleton, { id, triggerId });
+    existing.push(sideEffect);
+    writeFlowTree(slug, tree);
+    const needsUser = Object.entries(entry.owners ?? {}).filter(([, owner]) => owner !== "agent");
+    writeJson({
+      ok: true,
+      data: { slug, nodeId: node.id, sideEffectId: id, type, triggerId, path: flowDataPath(slug) },
+      hints: [
+        `Fires on \`${triggerId}\` \u2014 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.`,
+        // A pixel side effect is the thing most often mistaken for "setting the
+        // conversion". It tells the ad platform; it tells Baker nothing, and a
+        // Form can fire every pixel it has while every Baker report says it
+        // converted nobody.
+        ...needsUser.some(([, owner]) => owner === "tags") ? [
+          `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 \u2014 they are two different systems asked the same question.`
+        ] : [],
+        ...secondPixel ? [secondPixel] : [],
+        ...configureHints(
+          slug,
+          String(node.id),
+          id,
+          type,
+          needsUser.some(([, owner]) => owner === "request_flow_input" || owner === "connect")
+        ),
+        ...needsUser.some(([, owner]) => owner === "tags") ? [
+          "Fill `tagIds` with a real ref from `baker tags list`, or stage the tag first with the `tags` skill. Never invent one."
+        ] : [],
+        ...entry.gotcha ? [entry.gotcha] : []
+      ]
+    });
+  }
+});
+export {
+  addNodeCommand,
+  addSideEffectCommand,
+  freeSideEffectId,
+  resolveTrigger,
+  sameTrackingSideEffect,
+  secondPixelHint,
+  stepNameRefusal
+};
+//# sourceMappingURL=add-WFAYC64E.js.map

package/dist/add-WFAYC64E.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/ads-4FVN7UTX.js

@@ -0,0 +1,113 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-LFNVHAF3.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-DMXNT47S.js";
+import "./chunk-OAYHDIW2.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-KIGGMKAE.js";
+import {
+  apiGet
+} from "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import "./chunk-USFTTDIO.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-K7UNX4CE.js").then((m) => m.adsCreateCommand),
+    update: () => import("./write-commands-K7UNX4CE.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./write-commands-K7UNX4CE.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./write-commands-K7UNX4CE.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./write-commands-K7UNX4CE.js").then((m) => m.adsArchiveCommand),
+    delete: () => import("./write-commands-K7UNX4CE.js").then((m) => m.adsDeleteCommand),
+    duplicate: () => import("./write-commands-K7UNX4CE.js").then((m) => m.adsDuplicateCommand),
+    retag: () => import("./write-commands-K7UNX4CE.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-4FVN7UTX.js.map