@koda-sl/baker-cli 0.496.0 → 0.497.0

package/dist/add-LYDJZDGO.js

@@ -1,302 +0,0 @@
-import {
-  flowDataPath,
-  isUsableStepNameKey,
-  readFlowTree,
-  requestFlowInputCall,
-  stepNameKey,
-  walkNodes,
-  writeFlowTree
-} from "./chunk-Q3LXLWZY.js";
-import {
-  flowCatalogEntry,
-  flowCatalogTypes,
-  flowNodeTriggers
-} from "./chunk-DAO63OOP.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-WTJSMYY2.js";
-import "./chunk-6YLNY6CK.js";
-import "./chunk-D5NEIESR.js";
-import "./chunk-57KKVDDR.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-QANGHND7.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-LYDJZDGO.js.map

package/dist/add-LYDJZDGO.js.map

@@ -1 +0,0 @@
-{"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-DHPJFU52.js

@@ -1,40 +0,0 @@
-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-WYXDMH2N.js").then((m) => m.googleCommand),
-    meta: () => import("./meta-62YDR5B2.js").then((m) => m.metaCommand),
-    linkedin: () => import("./linkedin-UWZCF66X.js").then((m) => m.linkedinCommand),
-    x: () => import("./x-LXOJPCRF.js").then((m) => m.xCommand),
-    chatgpt: () => import("./chatgpt-YI6YNACI.js").then((m) => m.chatgptCommand)
-  }
-});
-export {
-  adsCommand
-};
-//# sourceMappingURL=ads-DHPJFU52.js.map

package/dist/advertisers-23LU7GTV.js

@@ -1,120 +0,0 @@
-import {
-  advertisersHints
-} from "./chunk-JH2L5CQD.js";
-import {
-  RESEARCH_DATA_NOTE,
-  handleResearchError,
-  writeResearchHints,
-  writeResearchJson,
-  writeResearchOutput
-} from "./chunk-EGPYWJGZ.js";
-import {
-  buildResearchQueryContext,
-  warnDefaults
-} from "./chunk-BDYLILMW.js";
-import "./chunk-SVM3DGAQ.js";
-import "./chunk-DAO63OOP.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-WTJSMYY2.js";
-import {
-  apiPost
-} from "./chunk-6YLNY6CK.js";
-import "./chunk-D5NEIESR.js";
-import "./chunk-57KKVDDR.js";
-import {
-  registerSchema
-} from "./chunk-QANGHND7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/research/advertisers.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "research.advertisers",
-  description: 'Returns a ranked list of domains competing for one keyword in Google, with avg SERP position, relevance rating, estimated traffic value and visibility \u2014 domain economics, not ad copy. Despite the name it returns no headlines, descriptions or creative of any kind; for a competitor\'s actual ad copy use `baker research google-ads <competitor.com> --copy` (Google) or `baker winning-ads content <adId>` (Meta/LinkedIn). Start here: `baker research advertisers "<keyword>" --location <cc> --language <code>` to size up who owns a term. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.',
-  args: {
-    keyword: {
-      type: "string",
-      description: "Keyword to search (positional). One search term, not a brand or a domain \u2014 this is a SERP query, not an advertiser lookup",
-      required: true
-    },
-    location: {
-      type: "string",
-      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
-      required: false
-    },
-    language: {
-      type: "string",
-      description: "Language code or name (en, es, spanish...). Defaults to en (English) if omitted \u2014 always set this for non-English markets",
-      required: false
-    },
-    limit: { type: "string", description: "Max results (default: 20, max: 100)", required: false },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  }
-});
-var FIELDS = {
-  domain: "Competing domain (no ad copy is returned \u2014 see hints)",
-  avg_position: "Average SERP position (1 = top)",
-  rating: "Domain relevance rating (0-100)",
-  etv: "Estimated traffic value (USD)",
-  visibility: "SERP visibility score (0-1)"
-};
-var advertisersCommand = defineCommand({
-  meta: {
-    name: "advertisers",
-    description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy \u2014 for a competitor's headlines and body copy use \`baker research google-ads <competitor.com> --copy\` (Google) or \`baker winning-ads content <adId>\` (Meta/LinkedIn).
-
-Examples:
-  baker research advertisers "running shoes"
-  baker research advertisers "crm software" --location uk --limit 10
-  baker research advertisers "zapatos" --location es --language spanish`
-  },
-  args: {
-    keyword: { type: "positional", description: "Keyword to search", required: true },
-    location: { type: "string", description: "Country code or location code (default: us)", required: false },
-    language: { type: "string", description: "Language code or name (default: en)", required: false },
-    limit: { type: "string", description: "Max results (default: 20, max: 100)", required: false },
-    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
-    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
-  },
-  run: async ({ args }) => {
-    const keyword = args.keyword;
-    const location = args.location || void 0;
-    const language = args.language || void 0;
-    const limit = args.limit ? Number(args.limit) : void 0;
-    const skipCache = args["no-cache"] ? true : void 0;
-    const queryContext = buildResearchQueryContext(location, language);
-    try {
-      const data = await apiPost("/api/research/advertisers", {
-        keyword,
-        location,
-        language,
-        limit,
-        skipCache
-      });
-      warnDefaults(queryContext);
-      const format = args.output || "json";
-      const hints = advertisersHints(data.length, queryContext);
-      if (format !== "json") {
-        writeResearchOutput(data, format);
-        writeResearchHints(hints, format);
-        return;
-      }
-      writeResearchJson({
-        ok: true,
-        data,
-        fields: FIELDS,
-        note: RESEARCH_DATA_NOTE,
-        query_context: queryContext,
-        hints
-      });
-    } catch (err) {
-      handleResearchError(err);
-    }
-  }
-});
-export {
-  advertisersCommand
-};
-//# sourceMappingURL=advertisers-23LU7GTV.js.map

package/dist/advertisers-23LU7GTV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/research/advertisers.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { advertisersHints } from \"./hints.ts\";\nimport {\n  handleResearchError,\n  RESEARCH_DATA_NOTE,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.advertisers\",\n  description:\n    'Returns a ranked list of domains competing for one keyword in Google, with avg SERP position, relevance rating, estimated traffic value and visibility — domain economics, not ad copy. Despite the name it returns no headlines, descriptions or creative of any kind; for a competitor\\'s actual ad copy use `baker research google-ads <competitor.com> --copy` (Google) or `baker winning-ads content <adId>` (Meta/LinkedIn). Start here: `baker research advertisers \"<keyword>\" --location <cc> --language <code>` to size up who owns a term. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.',\n  args: {\n    keyword: {\n      type: \"string\",\n      description:\n        \"Keyword to search (positional). One search term, not a brand or a domain — this is a SERP query, not an advertiser lookup\",\n      required: true,\n    },\n    location: {\n      type: \"string\",\n      description:\n        \"Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted — always set this for non-US markets\",\n      required: false,\n    },\n    language: {\n      type: \"string\",\n      description:\n        \"Language code or name (en, es, spanish...). Defaults to en (English) if omitted — always set this for non-English markets\",\n      required: false,\n    },\n    limit: { type: \"string\", description: \"Max results (default: 20, max: 100)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\ninterface Advertiser {\n  domain: string;\n  avg_position: number;\n  rating: number;\n  etv: number;\n  visibility: number;\n}\n\nconst FIELDS: Record<string, string> = {\n  domain: \"Competing domain (no ad copy is returned — see hints)\",\n  avg_position: \"Average SERP position (1 = top)\",\n  rating: \"Domain relevance rating (0-100)\",\n  etv: \"Estimated traffic value (USD)\",\n  visibility: \"SERP visibility score (0-1)\",\n};\n\nexport const advertisersCommand = defineCommand({\n  meta: {\n    name: \"advertisers\",\n    description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy — for a competitor's headlines and body copy use \\`baker research google-ads <competitor.com> --copy\\` (Google) or \\`baker winning-ads content <adId>\\` (Meta/LinkedIn).\n\nExamples:\n  baker research advertisers \"running shoes\"\n  baker research advertisers \"crm software\" --location uk --limit 10\n  baker research advertisers \"zapatos\" --location es --language spanish`,\n  },\n  args: {\n    keyword: { type: \"positional\", description: \"Keyword to search\", required: true },\n    location: { type: \"string\", description: \"Country code or location code (default: us)\", required: false },\n    language: { type: \"string\", description: \"Language code or name (default: en)\", required: false },\n    limit: { type: \"string\", description: \"Max results (default: 20, max: 100)\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const keyword = args.keyword as string;\n    const location = (args.location as string) || undefined;\n    const language = (args.language as string) || undefined;\n    const limit = args.limit ? Number(args.limit) : undefined;\n    const skipCache = args[\"no-cache\"] ? true : undefined;\n    const queryContext = buildResearchQueryContext(location, language);\n\n    try {\n      const data = await apiPost<Advertiser[]>(\"/api/research/advertisers\", {\n        keyword,\n        location,\n        language,\n        limit,\n        skipCache,\n      });\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      const hints = advertisersHints(data.length, queryContext);\n      if (format !== \"json\") {\n        writeResearchOutput(data as unknown as Array<Record<string, unknown>>, format);\n        writeResearchHints(hints, format);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data,\n        fields: FIELDS,\n        note: RESEARCH_DATA_NOTE,\n        query_context: queryContext,\n        hints,\n      });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAa9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAC7F,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AACF,CAAC;AAUD,IAAM,SAAiC;AAAA,EACrC,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,YAAY;AACd;AAEO,IAAM,qBAAqB,cAAc;AAAA,EAC9C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf;AAAA,EACA,MAAM;AAAA,IACJ,SAAS,EAAE,MAAM,cAAc,aAAa,qBAAqB,UAAU,KAAK;AAAA,IAChF,UAAU,EAAE,MAAM,UAAU,aAAa,+CAA+C,UAAU,MAAM;AAAA,IACxG,UAAU,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAChG,OAAO,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAC7F,QAAQ,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,OAAO;AAAA,IACrG,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,UAAU,KAAK;AACrB,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,QAAQ,KAAK,QAAQ,OAAO,KAAK,KAAK,IAAI;AAChD,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO;AAC5C,UAAM,eAAe,0BAA0B,UAAU,QAAQ;AAEjE,QAAI;AACF,YAAM,OAAO,MAAM,QAAsB,6BAA6B;AAAA,QACpE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,mBAAa,YAAY;AACzB,YAAM,SAAU,KAAK,UAAqB;AAC1C,YAAM,QAAQ,iBAAiB,KAAK,QAAQ,YAAY;AACxD,UAAI,WAAW,QAAQ;AACrB,4BAAoB,MAAmD,MAAM;AAC7E,2BAAmB,OAAO,MAAM;AAChC;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,QACA,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,eAAe;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}