@koda-sl/baker-cli 0.463.0 → 0.464.0

package/dist/ad-writes-SXSNOCH5.js

@@ -1,174 +0,0 @@
-import {
-  clearableArg,
-  compact,
-  cropArg,
-  lowerArg,
-  requireTarget,
-  schemaArgs,
-  stageChatgptOp,
-  statusCommand
-} from "./chunk-XZTEM2QG.js";
-import {
-  CHATGPT_ADS_REFERENCE
-} from "./chunk-HSTRHEEV.js";
-import "./chunk-3ITK2SBF.js";
-import "./chunk-TU6CHBNF.js";
-import "./chunk-E6VWLJVK.js";
-import "./chunk-7HD4SFUW.js";
-import {
-  registerSchema
-} from "./chunk-V2PX6XX5.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/chatgpt/ad-writes.ts
-import { defineCommand } from "citty";
-var REFERENCE = CHATGPT_ADS_REFERENCE.ads;
-var SHARED_ARGS = {
-  name: { type: "string", description: "Internal ad name (3+ characters)" },
-  title: { type: "string", description: "Card title, 3\u201350 characters" },
-  body: { type: "string", description: "Card text, up to 100 characters" },
-  "target-url": { type: "string", description: "Landing page, https://" },
-  "image-url": {
-    type: "string",
-    description: "Card image, https:// \u2014 PNG, JPEG, WebP or AVIF; square and 640 \xD7 640 px or larger reads best"
-  },
-  "image-crop": {
-    type: "string",
-    description: "The square of the image the card shows, as x,y,width,height shares from 0 to 1, e.g. 0.1,0,0.8,0.8 (default: chosen by ChatGPT Ads)"
-  },
-  "tracking-template": {
-    type: "string",
-    description: "Query string added to this card's landing page, e.g. ad_id={ad_id} \u2014 none clears"
-  },
-  status: { type: "string", description: "paused (default) | active" }
-};
-var CREATE_ARGS = {
-  ...SHARED_ARGS,
-  "ad-group-id": { type: "string", description: "adgrp_\u2026 or a staged chatgpt_temp_ ref", required: true },
-  name: { type: "string", description: "Internal ad name (3+ characters)", required: true },
-  title: { type: "string", description: "Card title, 3\u201350 characters", required: true },
-  body: { type: "string", description: "Card text, up to 100 characters", required: true },
-  "target-url": { type: "string", description: "Landing page, https://", required: true },
-  "image-url": { type: "string", description: "Card image, https://, at least 640 \xD7 640 px", required: true }
-};
-var UPDATE_ARGS = {
-  id: { type: "positional", description: "Ad id (ad_\u2026) or a staged chatgpt_temp_ ref", required: true },
-  ...SHARED_ARGS
-};
-function sharedPayload(args) {
-  return {
-    name: args.name,
-    title: args.title,
-    body: args.body,
-    targetUrl: args["target-url"],
-    imageUrl: args["image-url"],
-    imageCrop: cropArg(args["image-crop"], "--image-crop"),
-    trackingTemplate: clearableArg(args["tracking-template"]),
-    status: lowerArg(args.status)
-  };
-}
-function adCreateOp(args) {
-  return { kind: "ad.create", payload: compact({ ...sharedPayload(args), adGroupId: args["ad-group-id"] }) };
-}
-registerSchema({
-  command: "ads.chatgpt.ads.create",
-  description: "Stage a new chat card under a live ad group (adgrp_\u2026) or one staged in this chat. Every new card goes through ChatGPT Ads' review after publish before it serves.",
-  args: schemaArgs(CREATE_ARGS)
-});
-var adsCreateCommand = defineCommand({
-  meta: {
-    name: "create",
-    description: `Stage a new chat card (applies when the chat is published).
-
-Example:
-  baker ads chatgpt ads create --ad-group-id adgrp_123 --name "Card A" --title "Solar from 0 upfront" \\
-    --body "Get a quote in two minutes." --target-url https://example.com/solar --image-url https://example.com/card.png`
-  },
-  args: CREATE_ARGS,
-  run: async ({ args }) => {
-    await stageChatgptOp(adCreateOp(args), REFERENCE, () => [
-      "Review everything staged with `baker ads chatgpt draft`. It applies when the chat is published."
-    ]);
-  }
-});
-registerSchema({
-  command: "ads.chatgpt.ads.update",
-  description: "Stage a change to a chat card \u2014 any of title, body, landing page, image, name or status; the rest is kept from the live card. Changing the card sends it back to review.",
-  args: schemaArgs(UPDATE_ARGS)
-});
-var adsUpdateCommand = defineCommand({
-  meta: {
-    name: "update",
-    description: `Stage a change to a chat card; what you do not pass is kept.
-
-Examples:
-  baker ads chatgpt ads update ad_123 --title "Solar with no upfront cost"
-  baker ads chatgpt ads update ad_123 --target-url https://example.com/solar-v2`
-  },
-  args: UPDATE_ARGS,
-  run: async ({ args }) => {
-    await stageChatgptOp(
-      { kind: "ad.update", target: requireTarget(args, "id"), payload: compact(sharedPayload(args)) },
-      REFERENCE
-    );
-  }
-});
-var adsPauseCommand = statusCommand("ad", "pause", REFERENCE);
-var adsResumeCommand = statusCommand("ad", "resume", REFERENCE);
-var adsArchiveCommand = statusCommand("ad", "archive", REFERENCE);
-var PRODUCT_ARGS = {
-  "ad-group-id": {
-    type: "string",
-    description: "adgrp_\u2026 under a catalog campaign, or a staged chatgpt_temp_ ref",
-    required: true
-  },
-  name: { type: "string", description: "Internal ad name (3+ characters)", required: true },
-  title: {
-    type: "string",
-    description: "Title template (default {{product.title}}) \u2014 text with {{brand}}, {{product.title}}, {{product.body}}, {{product.price}}"
-  },
-  "tracking-template": { type: "string", description: "Query string added to each product's landing page" },
-  status: { type: "string", description: "paused (default) | active" }
-};
-function productAdCreateOp(args) {
-  return {
-    kind: "ad.create",
-    payload: compact({
-      format: "product_template",
-      adGroupId: args["ad-group-id"],
-      name: args.name,
-      title: args.title,
-      trackingTemplate: args["tracking-template"],
-      status: lowerArg(args.status)
-    })
-  };
-}
-registerSchema({
-  command: "ads.chatgpt.ads.create-product",
-  description: "Stage the product ad of a catalog ad group: one template each product fills with its own title, text, price, image and link. One per ad group.",
-  args: schemaArgs(PRODUCT_ARGS)
-});
-var adsCreateProductCommand = defineCommand({
-  meta: {
-    name: "create-product",
-    description: `Stage a product ad for a catalog ad group (applies when the chat is published).
-
-Example:
-  baker ads chatgpt ads create-product --ad-group-id adgrp_123 --name "Catalog ad" --title "{{brand}}: {{product.title}}"`
-  },
-  args: PRODUCT_ARGS,
-  run: async ({ args }) => {
-    await stageChatgptOp(productAdCreateOp(args), REFERENCE);
-  }
-});
-export {
-  adCreateOp,
-  adsArchiveCommand,
-  adsCreateCommand,
-  adsCreateProductCommand,
-  adsPauseCommand,
-  adsResumeCommand,
-  adsUpdateCommand,
-  productAdCreateOp
-};
-//# sourceMappingURL=ad-writes-SXSNOCH5.js.map

package/dist/add-4RUZX7BM.js

@@ -1,97 +0,0 @@
-import {
-  reportError
-} from "./chunk-LU2ZHDMY.js";
-import {
-  apiPost
-} from "./chunk-TU6CHBNF.js";
-import "./chunk-E6VWLJVK.js";
-import "./chunk-7HD4SFUW.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-V2PX6XX5.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/landing/inspiration/add.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "landing.inspiration.add",
-  description: "Add someone else's landing page to the reference library and save it to this company. Returns immediately \u2014 studying a page takes a few minutes, so never wait on it. Use it when the client names a site they admire, or when you find a competitor page worth learning from. Never point it at a page we built: it is refused, because the source is already in the project and reading a screenshot of it tells you less than opening the file.",
-  args: {
-    url: { type: "string", description: "Landing page address", required: true },
-    note: { type: "string", description: "Why this page is worth keeping", required: false },
-    refresh: {
-      type: "boolean",
-      description: "Study the page again even if it is already in the library. Use when the user says the page has changed or the saved sections look outdated",
-      required: false
-    }
-  }
-});
-function addHints(data, { refresh }) {
-  if (data.refreshDeclined === "studying") {
-    return [
-      "This page is already being studied \u2014 no second study was started. Search for it later in the turn or in a later one."
-    ];
-  }
-  if (data.refreshDeclined === "too_soon") {
-    return [
-      "This page was just studied a few minutes ago, so it was not studied again \u2014 its sections are already current.",
-      `Search it with: baker landing inspiration search --domain ${new URL(data.canonicalUrl).hostname}`
-    ];
-  }
-  if (data.alreadyKnown) {
-    return [
-      "This page was already in the library, so nothing was re-studied \u2014 its sections are searchable now.",
-      `Search it with: baker landing inspiration search --domain ${new URL(data.canonicalUrl).hostname}`,
-      "If the user says the live page looks different from what the library shows, run this again with --refresh."
-    ];
-  }
-  return [
-    refresh ? "Studying it again from the live site \u2014 this takes a few minutes. Until it lands, search results still show the old version, so don't build from them yet." : "Studying this page takes a few minutes. Don't wait on it \u2014 carry on, and search for it later in the turn or in a later one.",
-    "Meanwhile, search what is already in the library: baker landing inspiration search '<what you want to see>' --scope all",
-    "This is saved and being studied now, so it is listed as already applied \u2014 tell the user it is kept whatever they do with this chat.",
-    // The save is not a promise that the study succeeded. An agent that
-    // assumes it did will later search its own favorites, find nothing,
-    // and have no idea why.
-    "The save sticks even if the page turns out to be unreadable \u2014 `baker landing inspiration favorites` reports those separately as unreadable, so check there rather than assuming this page is searchable."
-  ];
-}
-var addCommand = defineCommand({
-  meta: {
-    name: "add",
-    description: "Add someone else's landing page to the reference library. Example: baker landing inspiration add https://linear.app --note 'the client likes this density'. Add --refresh to study a saved page again after the site changed"
-  },
-  args: {
-    url: { type: "positional", description: "Landing page address", required: true },
-    note: { type: "string", description: "Why this page is worth keeping", required: false },
-    refresh: {
-      type: "boolean",
-      description: "Study it again even if it is already in the library",
-      required: false,
-      default: false
-    }
-  },
-  run: async ({ args }) => {
-    try {
-      const data = await apiPost("/api/landing-inspiration/add", {
-        url: args.url,
-        note: args.note,
-        favorite: true,
-        refresh: args.refresh || void 0
-      });
-      const hints = addHints(data, { refresh: args.refresh });
-      writeJson({
-        ok: true,
-        data: { id: data.sourceId, url: data.canonicalUrl, status: data.status, already_known: data.alreadyKnown },
-        hints
-      });
-    } catch (error) {
-      reportError(error);
-    }
-  }
-});
-export {
-  addCommand,
-  addHints
-};
-//# sourceMappingURL=add-4RUZX7BM.js.map

package/dist/add-O3SZNUFV.js

@@ -1,105 +0,0 @@
-import {
-  compactSource,
-  reportError
-} from "./chunk-MOAMERFQ.js";
-import {
-  mediaSourcePlatformSchema,
-  mediaSourceRefreshIntervalSchema,
-  mediaSourcesAddRequestSchema
-} from "./chunk-GXDLWBOY.js";
-import {
-  apiPost
-} from "./chunk-TU6CHBNF.js";
-import "./chunk-E6VWLJVK.js";
-import "./chunk-7HD4SFUW.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-V2PX6XX5.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/media-sources/add.ts
-import { defineCommand } from "citty";
-registerSchema({
-  command: "media-sources.add",
-  description: "Connect a public social account as a source for the image and video libraries \u2014 Instagram, TikTok, YouTube (videos only), LinkedIn company pages, Facebook pages. Its recent posts (up to a year back) are imported. A Google Drive folder is not added here: ask for it with request_connection (platform google-drive, choose media-folder) and the user picks it in the chat. Everything is described and made searchable in the background. Applies immediately and shows on the chat as an already-applied change. Adding a source that is already connected is a no-op.",
-  args: {
-    input: {
-      type: "string",
-      description: "Profile URL (names its own platform), or @handle together with --platform",
-      required: true
-    },
-    platform: {
-      type: "string",
-      description: `Needed only for a bare handle: ${mediaSourcePlatformSchema.options.join("|")}`,
-      required: false
-    },
-    every: {
-      type: "string",
-      description: `Auto-sync cadence: ${mediaSourceRefreshIntervalSchema.options.join("|")} (default weekly for every source)`,
-      required: false
-    }
-  }
-});
-var addCommand = defineCommand({
-  meta: {
-    name: "add",
-    description: "Connect a social account (Instagram, TikTok, YouTube, LinkedIn page, Facebook page) as a media source. Start here with the profile URL. A Google Drive folder is never added by link: call request_connection with platform google-drive and choose media-folder, and the user picks the folder in the chat.\n\nExamples:\n  baker media-sources add https://www.tiktok.com/@acme\n  baker media-sources add @acme --platform instagram --every daily"
-  },
-  args: {
-    input: { type: "positional", description: "Profile URL or @handle", required: true },
-    platform: {
-      type: "string",
-      description: "instagram|tiktok|youtube|linkedin|facebook \u2014 only for a bare handle",
-      required: false
-    },
-    every: { type: "string", description: "Auto-sync: never|daily|weekly|monthly", required: false }
-  },
-  run: async ({ args }) => {
-    const parsed = mediaSourcesAddRequestSchema.safeParse({
-      input: String(args.input ?? ""),
-      platform: args.platform ? String(args.platform).toLowerCase() : void 0,
-      every: args.every ? String(args.every).toLowerCase() : void 0
-    });
-    if (!parsed.success) {
-      const issue = parsed.error.issues[0];
-      writeJson({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message: issue ? `${issue.path.join(".") || "input"}: ${issue.message}` : "Invalid request"
-        }
-      });
-      process.exit(1);
-    }
-    try {
-      const data = await apiPost("/api/media-sources/add", parsed.data, {
-        timeoutMs: 12e4
-      });
-      const hints = [
-        data.created ? `Connected ${data.source.label} on ${data.source.platformLabel}. Its posts are importing in the background \u2014 they become searchable with \`baker images search\` / \`baker videos search\` as each one is analysed. Check progress with \`baker media-sources list\`.` : `${data.source.label} on ${data.source.platformLabel} was already connected; a fresh import was started if one wasn't running.`
-      ];
-      if (data.source.platform === "youtube") {
-        hints.push(
-          "YouTube feeds the video library only, newest first, a batch per sync; videos over 20 minutes are skipped."
-        );
-      }
-      if (data.source.refreshInterval === "never") {
-        hints.push(
-          `Auto-sync is off. If the user wants new posts to keep arriving: \`baker media-sources schedule ${data.source.key} --every weekly\`.`
-        );
-      }
-      writeJson({
-        ok: true,
-        data: { created: data.created, source: compactSource(data.source), name: data.profile.displayName },
-        hints
-      });
-    } catch (err) {
-      reportError(err, parsed.data.input);
-    }
-  }
-});
-export {
-  addCommand
-};
-//# sourceMappingURL=add-O3SZNUFV.js.map

package/dist/add-SZGG4C2B.js

@@ -1,301 +0,0 @@
-import {
-  flowDataPath,
-  isUsableStepNameKey,
-  readFlowTree,
-  requestFlowInputCall,
-  stepNameKey,
-  walkNodes,
-  writeFlowTree
-} from "./chunk-DN4QLYWZ.js";
-import {
-  flowCatalogEntry,
-  flowCatalogTypes,
-  flowNodeTriggers
-} from "./chunk-ZJVHZHYP.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-ML7DLFFY.js";
-import "./chunk-TU6CHBNF.js";
-import "./chunk-E6VWLJVK.js";
-import "./chunk-7HD4SFUW.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-V2PX6XX5.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-SZGG4C2B.js.map