@koda-sl/baker-cli 0.448.0-dev.0d67e41b9 → 0.448.0-dev.ccc3c9a37

package/dist/funnel-WGFMUWQP.js

@@ -0,0 +1,394 @@
+import {
+  FUNNEL_VERTICALS,
+  funnelRequestSchema
+} from "./chunk-237WE5LX.js";
+import {
+  flowEventKeys
+} from "./chunk-S3XM4LD3.js";
+import {
+  flowDataPath,
+  listFlowSlugs
+} from "./chunk-PY4FAOW6.js";
+import {
+  parseEventKey
+} from "./chunk-BC2BXRXY.js";
+import "./chunk-EDLZGTGN.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-6SL6463H.js";
+import "./chunk-MAGSNHYB.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/funnel/index.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/funnel/formMoments.ts
+function offeredEndings(form) {
+  return flowEventKeys(form.tree, form.slug).filter((ending) => ending.isCompletion || ending.nodeId === null);
+}
+function formMoments(events, forms, counted) {
+  const endings = /* @__PURE__ */ new Map();
+  for (const form of forms) {
+    for (const ending of offeredEndings(form)) endings.set(ending.eventKey, { slug: form.slug, ending });
+  }
+  const known = events.map((event) => {
+    const found = endings.get(event.eventKey);
+    if (found === void 0) return event;
+    endings.delete(event.eventKey);
+    return { ...event, step: found.ending.nodeName };
+  });
+  const unfired = [...endings.values()].map(({ slug, ending }) => {
+    const countedAs = counted.get(ending.eventKey);
+    return {
+      eventKey: ending.eventKey,
+      origin: "site",
+      flowSlug: slug,
+      ...ending.nodeType === null ? {} : { nodeType: ending.nodeType },
+      events: 0,
+      sessions: 0,
+      step: ending.nodeName,
+      seen: false,
+      ...countedAs === void 0 ? {} : { countedAs }
+    };
+  });
+  return [...known, ...unfired];
+}
+function withFormMoments(moments, forms, counted) {
+  return { ...moments, events: formMoments(moments.events, forms, counted) };
+}
+function formsNamedHere(forms) {
+  return forms.filter((form) => flowEventKeys(form.tree, form.slug).length > 0).map((form) => form.slug);
+}
+function unplacedFormHints(steps, forms, counted) {
+  const onAStep = new Set(
+    steps.flatMap((step) => (step.triggers ?? []).flatMap((trigger) => trigger.eventKey ? [trigger.eventKey] : []))
+  );
+  const unplaced = [];
+  for (const form of forms) {
+    const endings = flowEventKeys(form.tree, form.slug);
+    if (endings.length === 0 || endings.some((ending) => onAStep.has(ending.eventKey))) continue;
+    const countedOn = endings.filter((ending) => counted.has(ending.eventKey));
+    unplaced.push(
+      countedOn.length === 0 ? form.slug : `${form.slug} (counted as ${countedOn.map((ending) => `"${counted.get(ending.eventKey)}" on \`${ending.eventKey}\``).join(", ")})`
+    );
+  }
+  if (unplaced.length === 0) return [];
+  return [
+    `${unplaced.length} Form(s) in this workspace reach no funnel step, so they move nobody along it however many people finish them: ${unplaced.join("; ")}. Which ending moves somebody to which step is your call: \`baker funnel --moments\` lists every Form's endings by the step each happens on, and when the step names do not make it obvious \u2014 a Form that branches into a rejection and a confirmation \u2014 ask the person which one means a lead or a customer. Place it with \`baker funnel --add-trigger <step> --event <key>\`. A Form already counted as a page conversion goes on the funnel by THAT SAME key, or the two numbers disagree for ever.`
+  ];
+}
+
+// src/commands/funnel/funnelArgs.ts
+var FunnelArgsError = class extends Error {
+  /** Structured remediation, in the shape the CLI's error envelope carries. */
+  fix;
+  constructor(message, fix) {
+    super(message);
+    this.name = "FunnelArgsError";
+    if (fix) {
+      this.fix = fix;
+    }
+  }
+};
+function parseFunnelArgs(raw) {
+  const steps = parseSteps(raw.steps);
+  const step = parseStep(raw.step);
+  const removeStep = parseRemoveStep(raw["remove-step"] ?? raw.removeStep);
+  const preset = parsePreset(raw.preset);
+  const addTrigger = parseWayIn(raw["add-trigger"] ?? raw.addTrigger, raw.event, "--add-trigger");
+  const removeTrigger = parseWayIn(raw["remove-trigger"] ?? raw.removeTrigger, raw.event, "--remove-trigger");
+  const doors = [steps, step, removeStep, preset, addTrigger, removeTrigger].filter(
+    (door) => door !== void 0
+  ).length;
+  if (doors > 1) {
+    throw new FunnelArgsError(
+      "Give one of --steps, --step, --remove-step, --preset, --add-trigger or --remove-trigger, not two."
+    );
+  }
+  const days = raw.days === void 0 ? void 0 : Number(raw.days);
+  if (days !== void 0 && (!Number.isInteger(days) || days <= 0 || days > 400)) {
+    throw new FunnelArgsError("--days must be a whole number of days, from 1 to 400.");
+  }
+  return {
+    ...steps === void 0 ? {} : { steps },
+    ...step === void 0 ? {} : { step },
+    ...removeStep === void 0 ? {} : { removeStep },
+    ...preset === void 0 ? {} : { preset },
+    ...addTrigger === void 0 ? {} : { addTrigger },
+    ...removeTrigger === void 0 ? {} : { removeTrigger },
+    templates: raw.templates === true,
+    moments: raw.moments === true,
+    ...days === void 0 ? {} : { days }
+  };
+}
+function funnelWrite(args2) {
+  const body = {
+    ...args2.steps === void 0 ? {} : { steps: args2.steps },
+    ...args2.step === void 0 ? {} : { step: args2.step },
+    ...args2.removeStep === void 0 ? {} : { removeStep: args2.removeStep },
+    ...args2.preset === void 0 ? {} : { preset: args2.preset },
+    ...args2.addTrigger === void 0 ? {} : { addTrigger: args2.addTrigger },
+    ...args2.removeTrigger === void 0 ? {} : { removeTrigger: args2.removeTrigger },
+    ...args2.templates ? { templates: true } : {},
+    ...args2.moments ? { moments: true } : {},
+    ...args2.days === void 0 ? {} : { days: args2.days }
+  };
+  const parsed = funnelRequestSchema.safeParse(body);
+  if (!parsed.success) {
+    const issue = parsed.error.issues[0];
+    throw new FunnelArgsError(
+      `That funnel cannot be sent \u2014 ${issue?.path.join(".") || "steps"}: ${issue?.message ?? "invalid"}`,
+      {
+        action: "read_the_schema",
+        explanation: "Run `baker schema funnel` for the exact shape of one step, or `baker funnel --templates` for sixteen worked examples plus every field an event carries."
+      }
+    );
+  }
+  return parsed.data;
+}
+function parseSteps(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (typeof raw !== "string") {
+    throw new FunnelArgsError("--steps takes a JSON array of steps.");
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (cause) {
+    throw new FunnelArgsError(`--steps is not valid JSON: ${cause instanceof Error ? cause.message : "parse failed"}`, {
+      action: "quote_the_json",
+      explanation: `Wrap the whole array in single quotes so the shell leaves the double quotes alone: --steps '[{"key":"lead",...}]'.`
+    });
+  }
+  if (!Array.isArray(parsed)) {
+    throw new FunnelArgsError("--steps takes an ARRAY of steps, even when the funnel has one step.");
+  }
+  refuseRetiredShapes(parsed);
+  return parsed;
+}
+function parseStep(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (typeof raw !== "string") {
+    throw new FunnelArgsError("--step takes one step as a JSON object.");
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (cause) {
+    throw new FunnelArgsError(`--step is not valid JSON: ${cause instanceof Error ? cause.message : "parse failed"}`, {
+      action: "quote_the_json",
+      explanation: `Wrap the object in single quotes so the shell leaves the double quotes alone: --step '{"key":"demo",...}'.`
+    });
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new FunnelArgsError("--step takes ONE step as an object. To restate several, use --steps with an array.");
+  }
+  refuseRetiredShapes([parsed]);
+  return parsed;
+}
+function parseRemoveStep(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (typeof raw !== "string" || raw.trim() === "") {
+    throw new FunnelArgsError("--remove-step takes the key of the step to take off, as `baker funnel` lists it.");
+  }
+  return raw.trim();
+}
+function refuseRetiredShapes(steps) {
+  for (const step of steps) {
+    if (typeof step !== "object" || step === null) continue;
+    const key = String(step.key ?? "?");
+    if ("offlineConversions" in step) {
+      throw new FunnelArgsError(`Step "${key}" puts sends on the step, and a send belongs to the conversion.`, {
+        action: "set_sends_on_the_conversion",
+        explanation: "Drop `offlineConversions`. Name the outcome with `baker analytics conversions`, then `baker analytics sends --set --conversion <name> --platform <p> --tag <tagId> --event <e>`; the step reads its conversions' sends back as `sends[]`."
+      });
+    }
+    const triggers = step.triggers;
+    if (!Array.isArray(triggers)) continue;
+    const kinds = triggers.map(
+      (trigger) => typeof trigger === "object" && trigger !== null ? trigger.kind : void 0
+    );
+    if (kinds.includes("analytics") || kinds.includes("conversion")) {
+      const word = kinds.includes("analytics") ? "analytics" : "conversion";
+      throw new FunnelArgsError(
+        `Step "${key}" has a \`${word}\` trigger, and a step is reached by an event or a landing only.`,
+        {
+          action: "use_an_event_trigger",
+          explanation: 'Pick the moment from `baker funnel --moments` and write it as `{"kind":"event","eventKey":"<from moments.events or moments.sources>"}` \u2014 nothing has to be named first. A landing is `{"kind":"landing","landingId":"<from moments.landings>"}`.'
+        }
+      );
+    }
+  }
+}
+function parsePreset(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (typeof raw !== "string" || !FUNNEL_VERTICALS.includes(raw)) {
+    throw new FunnelArgsError(`--preset must be one of: ${FUNNEL_VERTICALS.join(", ")}`, {
+      action: "list_the_presets",
+      explanation: "Run `baker funnel --templates` to see what each preset contains before picking one."
+    });
+  }
+  return raw;
+}
+function parseWayIn(stepKey, eventKey, flag) {
+  if (stepKey === void 0) return void 0;
+  if (typeof stepKey !== "string" || stepKey.trim() === "") {
+    throw new FunnelArgsError(`${flag} takes the key of the step to change: \`${flag} lead\`.`);
+  }
+  if (typeof eventKey !== "string" || eventKey.trim() === "") {
+    throw new FunnelArgsError(`${flag} needs --event, naming what gets somebody there.`, {
+      action: "read_the_moments",
+      explanation: `Run \`baker funnel --moments\` and copy an \`events[].eventKey\` \u2014 a Form's own outcome is listed there at zero before anybody has filled it in. Then: \`${flag} ${stepKey.trim()} --event "<key>"\`.`
+    });
+  }
+  const key = eventKey.trim();
+  if (flag === "--add-trigger" && parseEventKey(key) === null) {
+    throw new FunnelArgsError(`"${key}" is not an event key, so nothing would ever reach that step through it.`, {
+      action: "read_the_moments",
+      explanation: "Run `baker funnel --moments` and copy an `events[].eventKey`. They look like form:<form>:<step>:<trigger>, submit:<form>, page:<name> or view:<landing>."
+    });
+  }
+  return { stepKey: stepKey.trim(), eventKey: key };
+}
+
+// src/commands/funnel/index.ts
+var args = {
+  steps: {
+    type: "string",
+    description: 'The WHOLE funnel, as a JSON array. One object per step: {"key":"meeting_held","displayName":"Demo held","stepClass":"engaged","after":["lead"],"triggers":[{"id":"t1","kind":"event","eventKey":"page:demo_held"}]}. It REPLACES the funnel rather than adding to it, so read first and restate everything you want to keep. `key` is permanent and reaches reporting and URLs (lowercase, digits, underscores); `displayName` is the client\'s own words and can be anything. `stepClass` is the stage, one of visited, lead, engaged, customer, repeat, lost \u2014 six plain words every business has, used to compare one company\'s funnel with another\'s. `after` is a LIST, so two ways into one step is expressible and normal. `triggers` is what MOVES somebody onto the step, any one of them being enough, and there are three kinds: `{"id":"t1","kind":"event","eventKey":"submit:contact"}` for anything the company\'s Forms, pages or systems produced, used by its own key with nothing named first; `{"id":"t2","kind":"landing","landingId":"<from --moments>"}` for one landing page being viewed; `{"id":"t3","kind":"any_landing"}` for any landing being viewed. Take every key and id from `--moments`. A trigger carries no amount: an event is worth what it says, and a step is worth the sum. Where a step SENDS its people is not written here: a send belongs to the system\'s event (`baker analytics sends`), and the step reads it back as `sends[]`',
+    required: false
+  },
+  step: {
+    type: "string",
+    description: 'ONE step as a JSON object, in the same shape as an entry of --steps. It is added to the funnel as it now stands, or replaces the step with the same `key`, and every other step is left exactly as it is \u2014 the door for adding or changing a stage without restating the rest. Example: --step \'{"key":"demo","displayName":"Demo held","stepClass":"engaged","after":["lead"],"triggers":[{"id":"t1","kind":"event","eventKey":"page:demo_held"}]}\'',
+    required: false
+  },
+  "add-trigger": {
+    type: "string",
+    description: 'The key of ONE step to add a way in to, with `--event` naming what gets somebody there: `--add-trigger lead --event "submit:contact"`. Start here for "this Form should count as a lead" \u2014 it adds that one way in and leaves the step\'s name, stage, `after[]` and every other trigger exactly as they are. Prefer it to `--step`, which takes a WHOLE step and therefore silently removes any trigger the restatement forgets. Adding a key the step already listens for changes nothing. Take the key from `--moments`, never from memory',
+    required: false
+  },
+  "remove-trigger": {
+    type: "string",
+    description: 'The key of ONE step to take a way in OFF, with `--event` naming which: `--remove-trigger lead --event "submit:contact"`. By event key rather than by trigger id, because the id is not something you ever saw. Everything else about the step is untouched',
+    required: false
+  },
+  event: {
+    type: "string",
+    description: "The event key `--add-trigger` or `--remove-trigger` acts on \u2014 an `events[].eventKey` from `--moments`, never invented. Every Form's endings are listed there by the step each happens on, at zero before anybody has filled the Form in; which one means the step is your decision",
+    required: false
+  },
+  "remove-step": {
+    type: "string",
+    description: "The key of one step to take off the funnel. Whatever came after it moves up to whatever came before it, so the chain stays joined. The response lists it under `removed`",
+    required: false
+  },
+  preset: {
+    type: "string",
+    description: "Draw one of the ready-made graphs instead of stating steps: b2b_sales, b2b_inbound, saas_self_serve, saas_sales_assisted, ecommerce_purchase. It draws over the whole funnel \u2014 every company already has one, so prefer --step to change a step. Run --templates first to see what each one contains",
+    required: false
+  },
+  moments: {
+    type: "boolean",
+    description: "Also return everything a trigger can name, so a trigger is PICKED rather than invented: `events` (every event this company's Forms, pages and systems produced in the window, with volume, the Form it belongs to, `origin` \u2014 `site` for a page or Form, `systems` for the client's own server, `both` \u2014 and `countedAs` when the company also counts it as a page conversion, which a trigger does not need; PLUS **every workspace Form's endings** \u2014 each step's completion and its `submit:` \u2014 with the `step` each happens on, at zero and `seen: false` until somebody fires one, so a Form built minutes ago is pickable with nothing set up first, and `countedAs` when the company already counts it. Nothing is marked as the outcome: which ending means a step is YOUR decision \u2014 read the step names, and ask the person when they do not make it obvious (a Form that branches into \u201CNot a fit\u201D and \u201CQuote confirmed\u201D). If the Form is already counted, use that same key, so the step and the conversion agree. `baker analytics conversions --flow <slug>` also lists a widget's housekeeping), `sources` (the client's own systems that post events to Baker, by the `page:<name>` key each raises, pickable before its first send arrives) and `landings` (its pages, by the id a `landing` trigger takes). Use this before writing any `triggers`: a key typed from memory saves, publishes and counts nobody forever. A Form's events need NOTHING set up first \u2014 no Source, no conversion: a Baker page raises them by itself",
+    required: false
+  },
+  days: {
+    type: "string",
+    description: "How many days the counts beside each step cover (default 30, up to 400). Every step comes back with `people` (reached it), `atLeast` (reached it or anything after it), `before` (got as far as the step before) and `share` (atLeast / before) \u2014 counted in PEOPLE across visits and devices, not in visits",
+    required: false
+  },
+  templates: {
+    type: "boolean",
+    description: "Also return the libraries: the suggested steps with their stages, the presets, and `stages[]` (the six stages with the test to apply). Where a step can be sent is not here \u2014 a send belongs to the system's event, and `baker analytics sends` lists the platforms and the tags that can send",
+    required: false
+  }
+};
+registerSchema({
+  command: "funnel",
+  description: "Read the company's funnel, or draw one",
+  args
+});
+var funnelCommand = defineCommand({
+  meta: {
+    name: "funnel",
+    description: 'Start here: run with no flags to see the funnel this company has, with the last 30 days of PEOPLE counted beside every step \u2014 `people` reached it, `atLeast` got at least that far, `before` got as far as the step before, `share` is the ratio, and `worstStep` names where the most people are lost. Every company has one from the day it exists: Visited (any landing) \u2192 Became a lead \u2192 Became a customer, the last two with no way in until somebody gives them one. Then `--moments` for everything a trigger can name (every event the company\'s Forms, pages and systems produced, its sources, its landings, plus each Form\'s own outcome at zero). **To make an event count on a step \u2014 the usual job \u2014 use `--add-trigger <step> --event <key>`:** it adds that one way in and touches nothing else about the step. `--step \'<json>\'` is for adding or renaming a STEP; it replaces the step with that key, so it means restating its `after` and every trigger it keeps, and one left out is gone. A step is reached by three kinds of thing and nothing else: an event by its own key (`{"id":"t1","kind":"event","eventKey":"<from moments.events or moments.sources>"}`), one landing being viewed (`{"id":"t2","kind":"landing","landingId":"<from moments.landings>"}`) or any landing (`{"id":"t3","kind":"any_landing"}`). Nothing has to be named first. Pick every trigger from `--moments`, never from memory. A step with no `triggers` advances NOBODY and reports zero forever without warning \u2014 that is what the hints keep pointing at. There is no default door: a Form is only counted where a trigger names it. Keep it true: a chat that adds a Form, a Source or an event that moves people forward places it on its step in the same chat. Each step comes back with `sends[]`, read-only: where the people who reach it are sent and what happened, read off the system events behind its ways in. A send is set on the event with `baker analytics sends`, never on a step, and once published it spends ad budget \u2014 a failed one is named in the hints. Everything here is STAGED: it becomes the company\'s funnel in one piece when the chat is published \u2014 the client sees it on the canvas in this chat and can edit it there too \u2014 and the previous version stays on file so what was already measured under it is not lost.'
+  },
+  args,
+  run: async ({ args: raw }) => {
+    try {
+      const parsed = parseFunnelArgs(raw);
+      const forms = workspaceForms();
+      const namedByCaller = formsNamedHere(forms);
+      const request = {
+        ...funnelWrite(parsed),
+        ...namedByCaller.length === 0 ? {} : { namedByCaller }
+      };
+      const response = await apiPost("/api/funnel", request);
+      const counted = new Map((response.data.counted ?? []).map((row) => [row.eventKey, row.name]));
+      const data = response.data.moments === void 0 ? response.data : { ...response.data, moments: withFormMoments(response.data.moments, forms, counted) };
+      const hints = [...response.hints ?? [], ...unplacedFormHints(response.data.steps ?? [], forms, counted)];
+      writeJsonEnvelope({
+        ok: true,
+        data,
+        ...hints.length > 0 ? { hints } : {}
+      });
+    } catch (err) {
+      handleError(err);
+    }
+  }
+});
+function handleError(err) {
+  if (err instanceof FunnelArgsError) {
+    writeJsonEnvelope({
+      ok: false,
+      error: { code: "VALIDATION_ERROR", message: err.message, ...err.fix ? { fix: err.fix } : {} }
+    });
+    process.exit(1);
+  }
+  if (err instanceof ApiError) {
+    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  });
+  process.exit(1);
+}
+function workspaceForms() {
+  const forms = [];
+  for (const slug of listFlowSlugs()) {
+    try {
+      forms.push({ slug, tree: JSON.parse(readFileSync(flowDataPath(slug), "utf-8")) });
+    } catch {
+    }
+  }
+  return forms;
+}
+export {
+  funnelCommand
+};
+//# sourceMappingURL=funnel-WGFMUWQP.js.map

package/dist/funnel-WGFMUWQP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/funnel/index.ts","../src/commands/funnel/formMoments.ts","../src/commands/funnel/funnelArgs.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport type { FunnelRequest, FunnelResponse } from \"@baker/api/funnel\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\nimport { flowDataPath, listFlowSlugs } from \"../flows/shared.ts\";\nimport { formsNamedHere, unplacedFormHints, type WorkspaceForm, withFormMoments } from \"./formMoments.ts\";\nimport { FunnelArgsError, funnelWrite, parseFunnelArgs } from \"./funnelArgs.ts\";\n\n/**\n * `baker funnel` — the company's own funnel: the steps it has, in its own\n * words, wired the way its business actually runs.\n *\n * One command rather than a family, because there is one thing to say: this is\n * the funnel. A read with no flags, a write that restates the whole graph. It\n * is the only staged write in the CLI that does not take operations, and the\n * reason is in `@baker/api/funnel/wire.ts`: a funnel is a graph of a handful of\n * steps, so restating it costs nothing and the person reviewing it sees the\n * funnel they will get rather than a list of edits.\n */\nconst args = {\n  steps: {\n    type: \"string\",\n    description:\n      'The WHOLE funnel, as a JSON array. One object per step: {\"key\":\"meeting_held\",\"displayName\":\"Demo held\",\"stepClass\":\"engaged\",\"after\":[\"lead\"],\"triggers\":[{\"id\":\"t1\",\"kind\":\"event\",\"eventKey\":\"page:demo_held\"}]}. It REPLACES the funnel rather than adding to it, so read first and restate everything you want to keep. `key` is permanent and reaches reporting and URLs (lowercase, digits, underscores); `displayName` is the client\\'s own words and can be anything. `stepClass` is the stage, one of visited, lead, engaged, customer, repeat, lost — six plain words every business has, used to compare one company\\'s funnel with another\\'s. `after` is a LIST, so two ways into one step is expressible and normal. `triggers` is what MOVES somebody onto the step, any one of them being enough, and there are three kinds: `{\"id\":\"t1\",\"kind\":\"event\",\"eventKey\":\"submit:contact\"}` for anything the company\\'s Forms, pages or systems produced, used by its own key with nothing named first; `{\"id\":\"t2\",\"kind\":\"landing\",\"landingId\":\"<from --moments>\"}` for one landing page being viewed; `{\"id\":\"t3\",\"kind\":\"any_landing\"}` for any landing being viewed. Take every key and id from `--moments`. A trigger carries no amount: an event is worth what it says, and a step is worth the sum. Where a step SENDS its people is not written here: a send belongs to the system\\'s event (`baker analytics sends`), and the step reads it back as `sends[]`',\n    required: false,\n  },\n  step: {\n    type: \"string\",\n    description:\n      'ONE step as a JSON object, in the same shape as an entry of --steps. It is added to the funnel as it now stands, or replaces the step with the same `key`, and every other step is left exactly as it is — the door for adding or changing a stage without restating the rest. Example: --step \\'{\"key\":\"demo\",\"displayName\":\"Demo held\",\"stepClass\":\"engaged\",\"after\":[\"lead\"],\"triggers\":[{\"id\":\"t1\",\"kind\":\"event\",\"eventKey\":\"page:demo_held\"}]}\\'',\n    required: false,\n  },\n  \"add-trigger\": {\n    type: \"string\",\n    description:\n      'The key of ONE step to add a way in to, with `--event` naming what gets somebody there: `--add-trigger lead --event \"submit:contact\"`. Start here for \"this Form should count as a lead\" — it adds that one way in and leaves the step\\'s name, stage, `after[]` and every other trigger exactly as they are. Prefer it to `--step`, which takes a WHOLE step and therefore silently removes any trigger the restatement forgets. Adding a key the step already listens for changes nothing. Take the key from `--moments`, never from memory',\n    required: false,\n  },\n  \"remove-trigger\": {\n    type: \"string\",\n    description:\n      'The key of ONE step to take a way in OFF, with `--event` naming which: `--remove-trigger lead --event \"submit:contact\"`. By event key rather than by trigger id, because the id is not something you ever saw. Everything else about the step is untouched',\n    required: false,\n  },\n  event: {\n    type: \"string\",\n    description:\n      \"The event key `--add-trigger` or `--remove-trigger` acts on — an `events[].eventKey` from `--moments`, never invented. Every Form's endings are listed there by the step each happens on, at zero before anybody has filled the Form in; which one means the step is your decision\",\n    required: false,\n  },\n  \"remove-step\": {\n    type: \"string\",\n    description:\n      \"The key of one step to take off the funnel. Whatever came after it moves up to whatever came before it, so the chain stays joined. The response lists it under `removed`\",\n    required: false,\n  },\n  preset: {\n    type: \"string\",\n    description:\n      \"Draw one of the ready-made graphs instead of stating steps: b2b_sales, b2b_inbound, saas_self_serve, saas_sales_assisted, ecommerce_purchase. It draws over the whole funnel — every company already has one, so prefer --step to change a step. Run --templates first to see what each one contains\",\n    required: false,\n  },\n  moments: {\n    type: \"boolean\",\n    description:\n      \"Also return everything a trigger can name, so a trigger is PICKED rather than invented: `events` (every event this company's Forms, pages and systems produced in the window, with volume, the Form it belongs to, `origin` — `site` for a page or Form, `systems` for the client's own server, `both` — and `countedAs` when the company also counts it as a page conversion, which a trigger does not need; PLUS **every workspace Form's endings** — each step's completion and its `submit:` — with the `step` each happens on, at zero and `seen: false` until somebody fires one, so a Form built minutes ago is pickable with nothing set up first, and `countedAs` when the company already counts it. Nothing is marked as the outcome: which ending means a step is YOUR decision — read the step names, and ask the person when they do not make it obvious (a Form that branches into “Not a fit” and “Quote confirmed”). If the Form is already counted, use that same key, so the step and the conversion agree. `baker analytics conversions --flow <slug>` also lists a widget's housekeeping), `sources` (the client's own systems that post events to Baker, by the `page:<name>` key each raises, pickable before its first send arrives) and `landings` (its pages, by the id a `landing` trigger takes). Use this before writing any `triggers`: a key typed from memory saves, publishes and counts nobody forever. A Form's events need NOTHING set up first — no Source, no conversion: a Baker page raises them by itself\",\n    required: false,\n  },\n  days: {\n    type: \"string\",\n    description:\n      \"How many days the counts beside each step cover (default 30, up to 400). Every step comes back with `people` (reached it), `atLeast` (reached it or anything after it), `before` (got as far as the step before) and `share` (atLeast / before) — counted in PEOPLE across visits and devices, not in visits\",\n    required: false,\n  },\n  templates: {\n    type: \"boolean\",\n    description:\n      \"Also return the libraries: the suggested steps with their stages, the presets, and `stages[]` (the six stages with the test to apply). Where a step can be sent is not here — a send belongs to the system's event, and `baker analytics sends` lists the platforms and the tags that can send\",\n    required: false,\n  },\n} as const;\n\nregisterSchema({\n  command: \"funnel\",\n  description: \"Read the company's funnel, or draw one\",\n  args,\n});\n\nexport const funnelCommand = defineCommand({\n  meta: {\n    name: \"funnel\",\n    description:\n      'Start here: run with no flags to see the funnel this company has, with the last 30 days of PEOPLE counted beside every step — `people` reached it, `atLeast` got at least that far, `before` got as far as the step before, `share` is the ratio, and `worstStep` names where the most people are lost. Every company has one from the day it exists: Visited (any landing) → Became a lead → Became a customer, the last two with no way in until somebody gives them one. Then `--moments` for everything a trigger can name (every event the company\\'s Forms, pages and systems produced, its sources, its landings, plus each Form\\'s own outcome at zero). **To make an event count on a step — the usual job — use `--add-trigger <step> --event <key>`:** it adds that one way in and touches nothing else about the step. `--step \\'<json>\\'` is for adding or renaming a STEP; it replaces the step with that key, so it means restating its `after` and every trigger it keeps, and one left out is gone. A step is reached by three kinds of thing and nothing else: an event by its own key (`{\"id\":\"t1\",\"kind\":\"event\",\"eventKey\":\"<from moments.events or moments.sources>\"}`), one landing being viewed (`{\"id\":\"t2\",\"kind\":\"landing\",\"landingId\":\"<from moments.landings>\"}`) or any landing (`{\"id\":\"t3\",\"kind\":\"any_landing\"}`). Nothing has to be named first. Pick every trigger from `--moments`, never from memory. A step with no `triggers` advances NOBODY and reports zero forever without warning — that is what the hints keep pointing at. There is no default door: a Form is only counted where a trigger names it. Keep it true: a chat that adds a Form, a Source or an event that moves people forward places it on its step in the same chat. Each step comes back with `sends[]`, read-only: where the people who reach it are sent and what happened, read off the system events behind its ways in. A send is set on the event with `baker analytics sends`, never on a step, and once published it spends ad budget — a failed one is named in the hints. Everything here is STAGED: it becomes the company\\'s funnel in one piece when the chat is published — the client sees it on the canvas in this chat and can edit it there too — and the previous version stays on file so what was already measured under it is not lost.',\n  },\n  args,\n  run: async ({ args: raw }) => {\n    try {\n      const parsed = parseFunnelArgs(raw as Record<string, unknown>);\n      // Read once: every Form in this workspace, including the one built in\n      // this Session that the backend has never seen.\n      const forms = workspaceForms();\n      const namedByCaller = formsNamedHere(forms);\n      const request: FunnelRequest = {\n        ...funnelWrite(parsed),\n        ...(namedByCaller.length === 0 ? {} : { namedByCaller }),\n      };\n      const response = await apiPost<FunnelResponse>(\"/api/funnel\", request);\n      // What the company already counts, so a Form's ending can say so: the\n      // agent choosing a way in should put the same key on the step.\n      const counted = new Map((response.data.counted ?? []).map((row) => [row.eventKey, row.name] as const));\n      const data =\n        response.data.moments === undefined\n          ? response.data\n          : { ...response.data, moments: withFormMoments(response.data.moments, forms, counted) };\n      const hints = [...(response.hints ?? []), ...unplacedFormHints(response.data.steps ?? [], forms, counted)];\n      writeJsonEnvelope({\n        ok: true,\n        data,\n        ...(hints.length > 0 ? { hints } : {}),\n      });\n    } catch (err) {\n      handleError(err);\n    }\n  },\n});\n\n/**\n * A malformed `--steps` is the caller's own JSON, so it comes back as a\n * validation error carrying the parser's own sentence and its `fix` — the\n * request was never made, and \"that did not parse\" is something the agent can\n * act on in the same turn.\n */\nfunction handleError(err: unknown): never {\n  if (err instanceof FunnelArgsError) {\n    writeJsonEnvelope({\n      ok: false,\n      error: { code: \"VALIDATION_ERROR\", message: err.message, ...(err.fix ? { fix: err.fix } : {}) },\n    });\n    process.exit(1);\n  }\n  if (err instanceof ApiError) {\n    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });\n    process.exit(1);\n  }\n  writeJsonEnvelope({\n    ok: false,\n    error: { code: \"NETWORK_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" },\n  });\n  process.exit(1);\n}\n\n/**\n * Every Form in this workspace with its tree, skipping whatever cannot be read.\n *\n * Skipping rather than failing: `baker funnel` is one of the commands reached\n * for while a Form is half-written, and a flow-builder loop that has created\n * the folder but not yet the file would otherwise take the whole funnel down\n * with it. A Form left out costs one unfired ending in a list; a throw costs\n * the command.\n */\nfunction workspaceForms(): WorkspaceForm[] {\n  const forms: WorkspaceForm[] = [];\n  for (const slug of listFlowSlugs()) {\n    try {\n      forms.push({ slug, tree: JSON.parse(readFileSync(flowDataPath(slug), \"utf-8\")) });\n    } catch {\n      // Unreadable or not yet written.\n    }\n  }\n  return forms;\n}\n","import { type FlowEventKey, flowEventKeys } from \"@baker/api/analytics/flowEventKeys\";\nimport type { FunnelResponse } from \"@baker/api/funnel\";\n\n/**\n * A Form's endings, added to `--moments` before any of them has fired.\n *\n * `moments.events` is built from the event store, so it knows an event only\n * once somebody has produced one. A Form published this morning offered\n * nothing, and the picker's remaining affordances — type the key by hand, or\n * add a Source — are both wrong: a Source is a door for the company's own\n * systems, and a Baker page already raises its events natively. That is how a\n * funnel step ends up naming a key nothing produces, which never errors and\n * counts zero forever.\n *\n * Facts only. Which ending is the point of a Form is the agent's decision:\n * it is a reading of what the steps mean — \"Quote confirmed\" against \"Not a\n * fit\" — and a rule over the tree's shape picked the step both branches pass\n * through, which would have counted every rejected visitor as a lead. So\n * nothing here is marked as the outcome; each ending says the step it happens\n * on and whether the company already counts it, and the agent chooses.\n *\n * Pure, and the reading of the trees is the caller's: a half-written\n * `_data.json` under a flow-builder loop must not take out `baker funnel`.\n */\n\ntype Moments = NonNullable<FunnelResponse[\"data\"][\"moments\"]>;\ntype MomentEvent = Moments[\"events\"][number];\n\nexport interface WorkspaceForm {\n  slug: string;\n  tree: unknown;\n}\n\n/** Event key → the name the company counts it under, this chat's staged counts included. */\nexport type CountedNames = ReadonlyMap<string, string>;\n\n/**\n * Each step's completion and the Form's own submit — the endings a step could\n * mean. A widget's housekeeping (\"the booking page was viewed\") is left out:\n * it is never what a person means by reaching a step, it roughly doubled the\n * list, and `baker analytics conversions --flow <slug>` still has it.\n */\nfunction offeredEndings(form: WorkspaceForm): FlowEventKey[] {\n  return flowEventKeys(form.tree, form.slug).filter((ending) => ending.isCompletion || ending.nodeId === null);\n}\n\n/**\n * The store's events plus every workspace Form's endings, each with its step.\n *\n * An ending that has fired stays the store's own row, never replaced: it\n * carries a real volume, and a zero in its place would say the opposite of\n * what is true. It gains the step it happens on, which only the Form knows. An\n * ending nothing has fired yet is appended at zero, `seen: false`, with the\n * name the company counts it under when it counts it.\n */\nexport function formMoments(\n  events: readonly MomentEvent[],\n  forms: readonly WorkspaceForm[],\n  counted: CountedNames,\n): MomentEvent[] {\n  const endings = new Map<string, { slug: string; ending: FlowEventKey }>();\n  for (const form of forms) {\n    for (const ending of offeredEndings(form)) endings.set(ending.eventKey, { slug: form.slug, ending });\n  }\n\n  const known = events.map((event) => {\n    const found = endings.get(event.eventKey);\n    if (found === undefined) return event;\n    endings.delete(event.eventKey);\n    return { ...event, step: found.ending.nodeName };\n  });\n  const unfired = [...endings.values()].map(({ slug, ending }): MomentEvent => {\n    const countedAs = counted.get(ending.eventKey);\n    return {\n      eventKey: ending.eventKey,\n      origin: \"site\",\n      flowSlug: slug,\n      ...(ending.nodeType === null ? {} : { nodeType: ending.nodeType }),\n      events: 0,\n      sessions: 0,\n      step: ending.nodeName,\n      seen: false,\n      ...(countedAs === undefined ? {} : { countedAs }),\n    };\n  });\n  return [...known, ...unfired];\n}\n\n/** The moments as answered, with every workspace Form's endings alongside. */\nexport function withFormMoments(moments: Moments, forms: readonly WorkspaceForm[], counted: CountedNames): Moments {\n  return { ...moments, events: formMoments(moments.events, forms, counted) };\n}\n\n/**\n * The Forms {@link unplacedFormHints} speaks for, by slug — every one that\n * raises an ending at all.\n *\n * Sent with the request so the backend leaves them out of its own \"on no step\"\n * hint, and every unplaced Form is named once. A Form whose tree holds no step\n * is left to the backend, so it is still named.\n */\nexport function formsNamedHere(forms: readonly WorkspaceForm[]): string[] {\n  return forms.filter((form) => flowEventKeys(form.tree, form.slug).length > 0).map((form) => form.slug);\n}\n\n/**\n * The Forms in this workspace that no step counts, as ONE hint.\n *\n * The backend knows only PUBLISHED Forms, so a Form built in this Session was\n * named by nobody — on the one turn where the reminder is worth most. So this\n * owns the reminder for every Form in the workspace ({@link formsNamedHere})\n * and the backend's hint covers only the rest.\n *\n * It names Forms and never a key to place: the key is the agent's decision.\n * The one key it does print is a fact — the ending the company already counts\n * — because a step on a different ending of the same Form saves, publishes and\n * disagrees with the conversion for ever.\n *\n * One hint rather than one per Form, measured: a 27-Form client got 27\n * near-identical paragraphs, which is how an agent learns to skip the hints.\n * But every Form is named in it: the backend leaves all of them to this hint,\n * so a Form cut from the list here is named nowhere.\n */\nexport function unplacedFormHints(\n  steps: readonly { key: string; triggers?: readonly { eventKey?: string }[] }[],\n  forms: readonly WorkspaceForm[],\n  counted: CountedNames,\n): string[] {\n  const onAStep = new Set(\n    steps.flatMap((step) => (step.triggers ?? []).flatMap((trigger) => (trigger.eventKey ? [trigger.eventKey] : []))),\n  );\n  const unplaced: string[] = [];\n  for (const form of forms) {\n    const endings = flowEventKeys(form.tree, form.slug);\n    if (endings.length === 0 || endings.some((ending) => onAStep.has(ending.eventKey))) continue;\n    const countedOn = endings.filter((ending) => counted.has(ending.eventKey));\n    unplaced.push(\n      countedOn.length === 0\n        ? form.slug\n        : `${form.slug} (counted as ${countedOn.map((ending) => `\"${counted.get(ending.eventKey)}\" on \\`${ending.eventKey}\\``).join(\", \")})`,\n    );\n  }\n  if (unplaced.length === 0) return [];\n\n  return [\n    `${unplaced.length} Form(s) in this workspace reach no funnel step, so they move nobody along it however many people finish them: ${unplaced.join(\"; \")}. Which ending moves somebody to which step is your call: \\`baker funnel --moments\\` lists every Form's endings by the step each happens on, and when the step names do not make it obvious — a Form that branches into a rejection and a confirmation — ask the person which one means a lead or a customer. Place it with \\`baker funnel --add-trigger <step> --event <key>\\`. A Form already counted as a page conversion goes on the funnel by THAT SAME key, or the two numbers disagree for ever.`,\n  ];\n}\n","import { parseEventKey } from \"@baker/api/analytics\";\nimport { FUNNEL_VERTICALS, type FunnelRequest, funnelRequestSchema } from \"@baker/api/funnel\";\n\n/**\n * `baker funnel`'s flags, turned into the one request the route takes.\n *\n * Pure and tier-1 tested, because everything that can go wrong with this\n * command goes wrong here: hand-written JSON, a preset spelled from memory, and\n * a step whose ways in are half-written. Each of those has to come back as a\n * sentence the agent can act on in the same turn rather than as a request that\n * failed for a reason only the server can see.\n *\n * There is no `--forms` any more. It used to say which step each Form's\n * submissions entered, alongside a rule that dropped an unplaced Form on the\n * funnel's first step — so a funnel that measured a client's Forms\n * by accident was indistinguishable from one that measured them deliberately.\n * A Form reaches a step because a trigger on that step names it, and `baker\n * funnel`'s hints name every Form no step counts.\n */\n\nexport class FunnelArgsError extends Error {\n  /** Structured remediation, in the shape the CLI's error envelope carries. */\n  readonly fix?: { action: string; explanation: string };\n\n  constructor(message: string, fix?: { action: string; explanation: string }) {\n    super(message);\n    this.name = \"FunnelArgsError\";\n    if (fix) {\n      this.fix = fix;\n    }\n  }\n}\n\nexport interface FunnelArgs {\n  steps?: unknown[];\n  /** One step, added or replaced by key; the rest of the funnel is left as it stands. */\n  step?: unknown;\n  /** One step taken off by key. */\n  removeStep?: string;\n  /** One way in added to a step, by the event key it listens for. */\n  addTrigger?: { stepKey: string; eventKey: string };\n  /** One way in taken off a step. */\n  removeTrigger?: { stepKey: string; eventKey: string };\n  preset?: string;\n  templates: boolean;\n  moments: boolean;\n  days?: number;\n}\n\nexport function parseFunnelArgs(raw: Record<string, unknown>): FunnelArgs {\n  const steps = parseSteps(raw.steps);\n  const step = parseStep(raw.step);\n  const removeStep = parseRemoveStep(raw[\"remove-step\"] ?? raw.removeStep);\n  const preset = parsePreset(raw.preset);\n  const addTrigger = parseWayIn(raw[\"add-trigger\"] ?? raw.addTrigger, raw.event, \"--add-trigger\");\n  const removeTrigger = parseWayIn(raw[\"remove-trigger\"] ?? raw.removeTrigger, raw.event, \"--remove-trigger\");\n\n  const doors = [steps, step, removeStep, preset, addTrigger, removeTrigger].filter(\n    (door) => door !== undefined,\n  ).length;\n  if (doors > 1) {\n    throw new FunnelArgsError(\n      \"Give one of --steps, --step, --remove-step, --preset, --add-trigger or --remove-trigger, not two.\",\n    );\n  }\n\n  const days = raw.days === undefined ? undefined : Number(raw.days);\n  if (days !== undefined && (!Number.isInteger(days) || days <= 0 || days > 400)) {\n    throw new FunnelArgsError(\"--days must be a whole number of days, from 1 to 400.\");\n  }\n\n  return {\n    ...(steps === undefined ? {} : { steps }),\n    ...(step === undefined ? {} : { step }),\n    ...(removeStep === undefined ? {} : { removeStep }),\n    ...(preset === undefined ? {} : { preset }),\n    ...(addTrigger === undefined ? {} : { addTrigger }),\n    ...(removeTrigger === undefined ? {} : { removeTrigger }),\n    templates: raw.templates === true,\n    moments: raw.moments === true,\n    ...(days === undefined ? {} : { days }),\n  };\n}\n\n/**\n * The request body. Validated against the shared schema here rather than only\n * on the server, so a malformed step is named before a round trip — and named\n * as the step it is, which the server's first-issue message cannot always do.\n */\nexport function funnelWrite(args: FunnelArgs): FunnelRequest {\n  const body = {\n    ...(args.steps === undefined ? {} : { steps: args.steps }),\n    ...(args.step === undefined ? {} : { step: args.step }),\n    ...(args.removeStep === undefined ? {} : { removeStep: args.removeStep }),\n    ...(args.preset === undefined ? {} : { preset: args.preset }),\n    ...(args.addTrigger === undefined ? {} : { addTrigger: args.addTrigger }),\n    ...(args.removeTrigger === undefined ? {} : { removeTrigger: args.removeTrigger }),\n    ...(args.templates ? { templates: true } : {}),\n    ...(args.moments ? { moments: true } : {}),\n    ...(args.days === undefined ? {} : { days: args.days }),\n  };\n  const parsed = funnelRequestSchema.safeParse(body);\n  if (!parsed.success) {\n    const issue = parsed.error.issues[0];\n    throw new FunnelArgsError(\n      `That funnel cannot be sent — ${issue?.path.join(\".\") || \"steps\"}: ${issue?.message ?? \"invalid\"}`,\n      {\n        action: \"read_the_schema\",\n        explanation:\n          \"Run `baker schema funnel` for the exact shape of one step, or `baker funnel --templates` for sixteen worked examples plus every field an event carries.\",\n      },\n    );\n  }\n  return parsed.data;\n}\n\nfunction parseSteps(raw: unknown): unknown[] | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  if (typeof raw !== \"string\") {\n    throw new FunnelArgsError(\"--steps takes a JSON array of steps.\");\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (cause) {\n    throw new FunnelArgsError(`--steps is not valid JSON: ${cause instanceof Error ? cause.message : \"parse failed\"}`, {\n      action: \"quote_the_json\",\n      explanation:\n        'Wrap the whole array in single quotes so the shell leaves the double quotes alone: --steps \\'[{\"key\":\"lead\",...}]\\'.',\n    });\n  }\n  if (!Array.isArray(parsed)) {\n    throw new FunnelArgsError(\"--steps takes an ARRAY of steps, even when the funnel has one step.\");\n  }\n  refuseRetiredShapes(parsed);\n  return parsed;\n}\n\n/**\n * One step, as JSON. The same shape one entry of `--steps` takes, and the same\n * refusals — a step written the old way is refused here too.\n */\nfunction parseStep(raw: unknown): unknown | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  if (typeof raw !== \"string\") {\n    throw new FunnelArgsError(\"--step takes one step as a JSON object.\");\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (cause) {\n    throw new FunnelArgsError(`--step is not valid JSON: ${cause instanceof Error ? cause.message : \"parse failed\"}`, {\n      action: \"quote_the_json\",\n      explanation:\n        'Wrap the object in single quotes so the shell leaves the double quotes alone: --step \\'{\"key\":\"demo\",...}\\'.',\n    });\n  }\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    throw new FunnelArgsError(\"--step takes ONE step as an object. To restate several, use --steps with an array.\");\n  }\n  refuseRetiredShapes([parsed]);\n  return parsed;\n}\n\nfunction parseRemoveStep(raw: unknown): string | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  if (typeof raw !== \"string\" || raw.trim() === \"\") {\n    throw new FunnelArgsError(\"--remove-step takes the key of the step to take off, as `baker funnel` lists it.\");\n  }\n  return raw.trim();\n}\n\n/**\n * The shapes a step used to have and no longer does, refused by name.\n *\n * The wire schema would strip them silently: a step written with\n * `offlineConversions` would be stored without them and answer `ok`, and an\n * `analytics` or `conversion` trigger would be refused with zod's generic\n * discriminator message. Each has a home now — a send is set on the event, and\n * a way in is an event by its key with nothing to name first — so the refusal\n * says where.\n */\nfunction refuseRetiredShapes(steps: readonly unknown[]): void {\n  for (const step of steps) {\n    if (typeof step !== \"object\" || step === null) continue;\n    const key = String((step as { key?: unknown }).key ?? \"?\");\n    if (\"offlineConversions\" in step) {\n      throw new FunnelArgsError(`Step \"${key}\" puts sends on the step, and a send belongs to the conversion.`, {\n        action: \"set_sends_on_the_conversion\",\n        explanation:\n          \"Drop `offlineConversions`. Name the outcome with `baker analytics conversions`, then `baker analytics sends --set --conversion <name> --platform <p> --tag <tagId> --event <e>`; the step reads its conversions' sends back as `sends[]`.\",\n      });\n    }\n    const triggers = (step as { triggers?: unknown }).triggers;\n    if (!Array.isArray(triggers)) continue;\n    const kinds = triggers.map((trigger) =>\n      typeof trigger === \"object\" && trigger !== null ? (trigger as { kind?: unknown }).kind : undefined,\n    );\n    if (kinds.includes(\"analytics\") || kinds.includes(\"conversion\")) {\n      const word = kinds.includes(\"analytics\") ? \"analytics\" : \"conversion\";\n      throw new FunnelArgsError(\n        `Step \"${key}\" has a \\`${word}\\` trigger, and a step is reached by an event or a landing only.`,\n        {\n          action: \"use_an_event_trigger\",\n          explanation:\n            'Pick the moment from `baker funnel --moments` and write it as `{\"kind\":\"event\",\"eventKey\":\"<from moments.events or moments.sources>\"}` — nothing has to be named first. A landing is `{\"kind\":\"landing\",\"landingId\":\"<from moments.landings>\"}`.',\n        },\n      );\n    }\n  }\n}\n\nfunction parsePreset(raw: unknown): string | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  if (typeof raw !== \"string\" || !(FUNNEL_VERTICALS as readonly string[]).includes(raw)) {\n    throw new FunnelArgsError(`--preset must be one of: ${FUNNEL_VERTICALS.join(\", \")}`, {\n      action: \"list_the_presets\",\n      explanation: \"Run `baker funnel --templates` to see what each preset contains before picking one.\",\n    });\n  }\n  return raw;\n}\n\n/**\n * `--add-trigger <step> --event <key>`, or a refusal naming the missing half.\n *\n * Two flags rather than one JSON object, because that is the whole point of\n * this door: the thing being asked is \"this event should count on that step\",\n * and asking for JSON here would put the caller back in the business of\n * hand-writing a shape. The event key is still never invented — `--moments`\n * is where it comes from, and the refusal says so.\n */\nfunction parseWayIn(\n  stepKey: unknown,\n  eventKey: unknown,\n  flag: string,\n): { stepKey: string; eventKey: string } | undefined {\n  if (stepKey === undefined) return undefined;\n  if (typeof stepKey !== \"string\" || stepKey.trim() === \"\") {\n    throw new FunnelArgsError(`${flag} takes the key of the step to change: \\`${flag} lead\\`.`);\n  }\n  if (typeof eventKey !== \"string\" || eventKey.trim() === \"\") {\n    throw new FunnelArgsError(`${flag} needs --event, naming what gets somebody there.`, {\n      action: \"read_the_moments\",\n      explanation: `Run \\`baker funnel --moments\\` and copy an \\`events[].eventKey\\` — a Form's own outcome is listed there at zero before anybody has filled it in. Then: \\`${flag} ${stepKey.trim()} --event \"<key>\"\\`.`,\n    });\n  }\n  const key = eventKey.trim();\n  // Refused here rather than at the backend, and only when ADDING: a key\n  // nothing can produce does not error downstream, it counts zero for ever.\n  // Removing is the opposite case — a key already on a step precisely because\n  // it was wrong has to stay removable, whatever it parses as.\n  if (flag === \"--add-trigger\" && parseEventKey(key) === null) {\n    throw new FunnelArgsError(`\"${key}\" is not an event key, so nothing would ever reach that step through it.`, {\n      action: \"read_the_moments\",\n      explanation:\n        \"Run `baker funnel --moments` and copy an `events[].eventKey`. They look like form:<form>:<step>:<trigger>, submit:<form>, page:<name> or view:<landing>.\",\n    });\n  }\n  return { stepKey: stepKey.trim(), eventKey: key };\n}\n"],"mappings":"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","names":["args"]}

package/dist/ga4-YDKXVJOC.js

@@ -0,0 +1,55 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ga4/index.ts
+import { defineCommand } from "citty";
+var ga4Command = defineCommand({
+  meta: {
+    name: "ga4",
+    description: `Google Analytics 4. Report on a property, audit its config, and change what it measures.
+
+Start here:
+  baker ga4 properties                    \u2014 list accessible properties
+  baker ga4 config                        \u2014 what the property measures today (and whether Baker may change it)
+  baker ga4 query --list-presets          \u2014 see available report presets
+
+Report:
+  baker ga4 audit                                                    \u2014 full property health check
+  baker ga4 query --preset tracking-health                           \u2014 compare GA4 vs GAds data
+  baker ga4 query --dimensions "date" --metrics "sessions" --days 7  \u2014 free-form query
+
+Then stage changes (nothing is sent to Google Analytics until the chat completes):
+  baker ga4 key-event create --json '{"eventName":"generate_lead","countingMethod":"ONCE_PER_EVENT"}'
+  baker ga4 custom-event create --json '{"destinationEvent":"quote_request","eventConditions":[...]}'
+  baker ga4 custom-dimension create --json '{"parameterName":"plan_tier","displayName":"Plan tier","scope":"EVENT"}'
+  baker ga4 audience create --json '{"displayName":"Visited without demo", \u2026}'   \u2014 a group to retarget
+  baker ga4 property set --industry TECHNOLOGY                                   \u2014 benchmarking cohort
+  baker ga4 ads-link create --customer-id 123-456-7890                           \u2014 what makes audiences targetable
+  baker ga4 enhanced-measurement set --scrolls true --outbound-clicks true        \u2014 automatic events, no tag needed
+  baker ga4 draft list                    \u2014 review everything staged
+
+An applied change takes effect on the property immediately \u2014 there is no version to publish afterwards
+and no undo. Agree the changes with the user before the chat completes, not after.
+
+Full guide: __tooling__/docs/tools/baker/ga4.md`
+  },
+  subCommands: {
+    properties: () => import("./properties-NYNEONHI.js").then((m) => m.propertiesCommand),
+    config: () => import("./config-UE7GCROG.js").then((m) => m.configCommand),
+    audit: () => import("./audit-JR5R75XK.js").then((m) => m.auditCommand),
+    query: () => import("./query-RK2TFMBI.js").then((m) => m.queryCommand),
+    "key-event": () => import("./write-commands-47OP673X.js").then((m) => m.keyEventCommand),
+    "custom-dimension": () => import("./write-commands-47OP673X.js").then((m) => m.customDimensionCommand),
+    "custom-metric": () => import("./write-commands-47OP673X.js").then((m) => m.customMetricCommand),
+    "custom-event": () => import("./write-commands-47OP673X.js").then((m) => m.customEventCommand),
+    "data-retention": () => import("./write-commands-47OP673X.js").then((m) => m.dataRetentionCommand),
+    audience: () => import("./write-commands-47OP673X.js").then((m) => m.audienceCommand),
+    property: () => import("./write-commands-47OP673X.js").then((m) => m.propertyCommand),
+    "ads-link": () => import("./write-commands-47OP673X.js").then((m) => m.adsLinkCommand),
+    "enhanced-measurement": () => import("./write-commands-47OP673X.js").then((m) => m.enhancedMeasurementCommand),
+    draft: () => import("./draft-NWLPLTWM.js").then((m) => m.draftCommand)
+  }
+});
+export {
+  ga4Command
+};
+//# sourceMappingURL=ga4-YDKXVJOC.js.map