@koda-sl/baker-cli 0.452.0 → 0.453.0-dev.914a088e4

package/dist/funnel-MQ2QSCXI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/funnel/index.ts","../src/commands/funnel/formMoments.ts","../../api/src/funnel/vocabulary.ts","../../api/src/funnel/stepTemplates.ts","../../api/src/funnel/wire.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","/**\n * The one closed vocabulary in a funnel that is otherwise the company's own.\n *\n * A company invents its own steps, in its own words, wired its own way\n * (`graph.ts`). What it cannot invent is the *stage* a step stands for: the\n * six words below are what keeps one company's funnel comparable with\n * another's, and they can stay closed because they describe the shape every\n * business has — somebody saw the offer, told you who they are, did something\n * real with you, paid, paid again, or went away — rather than any one sector's\n * name for a rung on it.\n *\n * Six, down from eight. The old list split \"qualified\", \"engaged\" and\n * \"committed\" apart, and \"lost\" from \"disqualified\", which read as a sales\n * team's pipeline and meant nothing to a shop, a clinic or a course. Every\n * step that was one of those three is a real forward interaction and is\n * `engaged`; every step that ends the journey without money is `lost`.\n *\n * These lists are mirrored from `packages/backend/convex/lib/validators.ts`,\n * which is the source of truth for what can be stored. They are re-declared\n * here rather than imported because `@baker/api` must not depend on `convex`;\n * `vocabulary.parity.test.ts` reads that file and fails if the two ever drift.\n */\n\n/**\n * The stage a funnel step stands for, never the step itself.\n *\n * Ordered as a journey runs, and **the order is meaningful**: it is the\n * fallback for comparing one company's funnel against another's when their\n * graphs cannot be laid over each other, and the tie-break for \"how far did\n * this person get\" between two steps at the same depth.\n *\n * Where a step is sent is never derived from this list — that lives per step\n * — which is exactly why it does not have to be exhaustive.\n */\nexport const FUNNEL_STEP_CLASSES = [\n  /** Saw the offer: a landing opened, an ad clicked through. */\n  \"visited\",\n  /** We know who they are: a form sent, an account created. */\n  \"lead\",\n  /** Something real happened: a call booked, a trial started, a quote asked for, a cart filled. */\n  \"engaged\",\n  /** Paid, or signed. */\n  \"customer\",\n  /** Paid again, renewed, or grew. */\n  \"repeat\",\n  /** Terminal. Did not go ahead, or was never a fit. */\n  \"lost\",\n] as const;\nexport type FunnelStepClass = (typeof FUNNEL_STEP_CLASSES)[number];\n\n/**\n * Each stage in plain words, with an example from three shapes of business.\n *\n * The stage is the only thing in a funnel a company does not get to invent, so\n * it is the only thing anybody has to be *taught* — and it was taught in five\n * words on a `<select>`: \"Engaged — did something real with you\". A marketer\n * setting up a demo-led funnel, a self-serve trial and a shop cannot tell from\n * that whether a trial is engaged or customer, and getting it wrong is\n * invisible: nothing on their own reports changes, and the cross-company\n * comparison this list exists for quietly stops working.\n *\n * So each one says what it means in a sentence a child could follow, and then\n * shows the same stage in three businesses that look nothing like each other.\n * Three, because that is the range that makes the rule legible — a shop has no\n * demo and a self-serve product has no salesperson, and a stage that survives\n * all three is a stage somebody can place their own step into.\n *\n * Here rather than in the dashboard because the agent needs the same words:\n * `baker funnel --templates` returns it, the stage picker renders it, and\n * `docs/product-model.md` quotes it.\n */\nexport interface FunnelStageGuide {\n  /** One word for the chip on a card. */\n  title: string;\n  /** What it means, said once, plainly. */\n  meaning: string;\n  /** The test somebody applies to their own step to decide if it belongs here. */\n  test: string;\n  /** The same stage in three businesses: an online shop, a self-serve product, a sales-led business. */\n  examples: { shop: string; selfServe: string; salesLed: string };\n}\n\nexport const FUNNEL_STAGE_GUIDE: Readonly<Record<FunnelStepClass, FunnelStageGuide>> = {\n  visited: {\n    title: \"Visited\",\n    meaning: \"They looked, and that is all. You still have no idea who they are.\",\n    test: \"Could this have happened without them telling you anything about themselves?\",\n    examples: {\n      shop: \"Opened a product page\",\n      selfServe: \"Read the pricing page\",\n      salesLed: \"Read a case study\",\n    },\n  },\n  lead: {\n    title: \"Lead\",\n    meaning: \"Now you know who they are. They handed over a way to reach them.\",\n    test: \"Do you have their email, their phone, or an account in their name?\",\n    examples: {\n      shop: \"Joined the newsletter\",\n      selfServe: \"Created a free account\",\n      salesLed: \"Asked for a demo\",\n    },\n  },\n  engaged: {\n    title: \"Engaged\",\n    meaning: \"They did something real — more than reading, not yet paying.\",\n    test: \"Did they spend effort or time on you, without any money changing hands?\",\n    examples: {\n      shop: \"Put something in the basket\",\n      selfServe: \"Started a trial, or invited a colleague\",\n      salesLed: \"Turned up to the demo, or asked for a quote\",\n    },\n  },\n  customer: {\n    title: \"Customer\",\n    meaning: \"Money. They paid, or they signed something that means they will.\",\n    test: \"Is there a first payment or a signed contract behind this?\",\n    examples: {\n      shop: \"Placed their first order\",\n      selfServe: \"Started paying for a plan\",\n      salesLed: \"Signed the contract\",\n    },\n  },\n  repeat: {\n    title: \"Repeat\",\n    meaning: \"Money again. They came back, renewed, or bought more.\",\n    test: \"Had they already paid you once before this happened?\",\n    examples: {\n      shop: \"Ordered a second time\",\n      selfServe: \"Renewed, or moved to a bigger plan\",\n      salesLed: \"Renewed the contract, or added seats\",\n    },\n  },\n  lost: {\n    title: \"Lost\",\n    meaning: \"It ended, and no money came. Nothing comes after this step.\",\n    test: \"Is this journey over without a sale — for now or for good?\",\n    examples: {\n      shop: \"Left the basket and never came back\",\n      selfServe: \"The trial ran out unused\",\n      salesLed: \"They went with somebody else\",\n    },\n  },\n};\n\n/**\n * The stages that end a journey without money. One word now: the old split\n * between \"it was real and did not close\" and \"it never was real\" is a\n * judgement a sales team makes and nobody else does, and the two read as one\n * loss rate on every report anyway.\n */\nexport const TERMINAL_NEGATIVE_CLASSES = [\"lost\"] as const;\n\nexport function isTerminalNegative(stepClass: FunnelStepClass): boolean {\n  return (TERMINAL_NEGATIVE_CLASSES as readonly string[]).includes(stepClass);\n}\n\n/** The stages that mean money arrived: where a funnel is expected to end. */\nexport const MONEY_CLASSES = [\"customer\", \"repeat\"] as const;\n\nexport function isMoneyClass(stepClass: FunnelStepClass): boolean {\n  return (MONEY_CLASSES as readonly string[]).includes(stepClass);\n}\n\n/** Where a stage sits in the journey's order — the cross-company fallback. */\nexport function stepClassRank(stepClass: FunnelStepClass): number {\n  return FUNNEL_STEP_CLASSES.indexOf(stepClass);\n}\n\n/**\n * A company step key: lowercase letters, digits and underscores, 1–64\n * characters, no leading or trailing underscore.\n *\n * Constrained on purpose even though the vocabulary is open. The key is the\n * stable identifier for the step — it ends up in reporting arguments, CLI\n * arguments and URLs — so it must not be able to be `\"Deal — won (EU)\"`. The\n * client's own words live in `displayName`, which has no constraint at all,\n * and renaming a step never touches its key.\n */\nconst STEP_KEY = /^[a-z0-9](?:[a-z0-9_]{0,62}[a-z0-9])?$/;\n\nexport function isFunnelStepKey(value: string): boolean {\n  return STEP_KEY.test(value);\n}\n\nexport function isFunnelStepClass(value: string): value is FunnelStepClass {\n  return (FUNNEL_STEP_CLASSES as readonly string[]).includes(value);\n}\n","/**\n * Step templates — a curated library of steps most funnels have, kept as\n * suggestions and never as law.\n *\n * The vocabulary is the company's: it invents its own steps, in its own words.\n * That does not mean everybody should have to invent \"Meeting booked\" from\n * nothing at kickoff, and it does not mean the research behind what each of\n * these moments means, whether it carries money, and what it becomes on Meta,\n * Google Ads and LinkedIn has to be re-derived per client.\n *\n * So the tables live here, as suggestion rather than schema:\n *\n * - **Nothing validates against this file.** A company step needs a class and a\n *   graph, and neither has to come from a template. `graph.ts` never reads this\n *   module.\n * - The funnel canvas offers templates when a step is created, and\n *   `VERTICAL_PRESETS` offers four small ready-made graphs for the cold start.\n * - `platformDefaults` is the **prefill** for an offline conversion added to a\n *   templated step — \"send this one to Meta\" on a won-like step should propose\n *   `Purchase`, not an empty box (`defaultOfflineEvent`). Every value is\n *   overridable; it is a default, not a mapping, and it is deliberately per\n *   template rather than per class, so that where a conversion is sent never\n *   becomes something the class decides.\n *\n * Pure data plus two derivations, tier-1 tested.\n */\n\nimport type { FunnelStepDefinition } from \"./graph\";\nimport type { FunnelStepClass } from \"./vocabulary\";\n\n/**\n * What a step usually becomes on Meta. The event name travels in the payload,\n * so anything goes — but a standard event optimizes better than a custom one,\n * which is why `standard` is recorded rather than left to be guessed from the\n * name.\n */\nexport interface MetaEventDefault {\n  eventName: string;\n  standard: boolean;\n}\n\n/**\n * The category Google Ads makes you pick when the conversion action is created.\n * `alternative` exists for the one genuine fork: a closed deal is \"Converted\n * lead\" in the lead funnel and \"Purchase\" once a revenue amount is reported,\n * and only the company knows which it is reporting.\n */\nexport interface GoogleAdsConversionDefault {\n  category: string;\n  alternative?: string;\n}\n\n/**\n * The `type` LinkedIn makes you pick when the conversion rule is created.\n *\n * `verified: false` carries a type taken from the documentation and never\n * checked against the live enum, so a creation attempt has to fall back to\n * `fallback` instead of failing.\n */\nexport interface LinkedinConversionDefault {\n  type: string;\n  verified: boolean;\n  fallback?: string;\n}\n\nexport interface FunnelPlatformDefaults {\n  meta?: MetaEventDefault;\n  googleAds?: GoogleAdsConversionDefault;\n  linkedin?: LinkedinConversionDefault;\n}\n\nexport interface FunnelStepTemplate {\n  /** Suggested key. A company may rename it; nothing here is a stable identifier. */\n  key: string;\n  /** Suggested name, in a marketer's words. The company's own name wins. */\n  displayName: string;\n  /** One line, shown next to the suggestion so nobody has to guess what it covers. */\n  meaning: string;\n  stepClass: FunnelStepClass;\n  /**\n   * Other names for the same moment, lowercase and in English.\n   *\n   * Read only by `suggestStepForName`, which guesses a step for a name that has\n   * arrived from somewhere else — a CRM stage, a spreadsheet column, whatever a\n   * later source turns out to speak. Nothing validates against them and a match\n   * is never applied on its own; a person still confirms it.\n   */\n  aliases: readonly string[];\n  /**\n   * Prefill for a destination created on a step made from this template.\n   * Absent per platform where the old table said \"never sent\".\n   */\n  platformDefaults: FunnelPlatformDefaults;\n  /** Why this class, where the answer is not obvious. Shown to nobody; read by whoever edits this file. */\n  classNote?: string;\n}\n\n/**\n * Sixteen steps, each with the stage it belongs to.\n *\n * On the stage mapping, where it took a decision rather than a lookup:\n *\n * - **`lead` is \"we know who they are\", not \"they did something small\".**\n *   `lead` and `signed_up` are the same fact reached two ways, so both are\n *   `lead` even though one is a form and the other an account.\n * - **`engaged` is the wide one, and that is deliberate.** Qualified, cart,\n *   checkout, trial, outreach, meeting booked, meeting held and an open\n *   opportunity are all \"something real happened\" before any money. Splitting\n *   them further is what the old eight-word list did, and it read as a sales\n *   team's pipeline to everybody who was not one.\n * - **`customer` is the first money, `repeat` is the money after it.**\n *   `subscribed` is therefore `customer`, not `repeat`: it is the moment a\n *   subscription starts paying. `renewed` is what `repeat` is for.\n */\nexport const FUNNEL_STEP_TEMPLATES: readonly FunnelStepTemplate[] = [\n  {\n    key: \"saw_offer\",\n    displayName: \"Saw the offer\",\n    meaning: \"Someone opened one of your landing pages — where most journeys start\",\n    stepClass: \"visited\",\n    classNote: \"The only `visited` template: a landing being viewed is a step, never an outcome.\",\n    aliases: [\"saw the offer\", \"visited\", \"landing viewed\", \"page viewed\", \"visit\", \"visitor\"],\n    // Never sent anywhere: every platform already counts its own page views,\n    // and uploading a view as a conversion would teach it to optimise for\n    // nothing.\n    platformDefaults: {},\n  },\n  {\n    key: \"lead\",\n    displayName: \"Lead\",\n    meaning: \"Someone left their details — the starting point of most journeys\",\n    stepClass: \"lead\",\n    aliases: [\"lead\", \"new lead\", \"inbound lead\", \"enquiry\", \"inquiry\", \"form submission\"],\n    platformDefaults: {\n      meta: { eventName: \"Lead\", standard: true },\n      googleAds: { category: \"Submit lead form\" },\n      linkedin: { type: \"LEAD\", verified: true },\n    },\n  },\n  {\n    key: \"signed_up\",\n    displayName: \"Signed up\",\n    meaning: \"Someone created an account\",\n    stepClass: \"lead\",\n    classNote: \"Same fact as a lead reached a different way — we now know who they are.\",\n    aliases: [\"signed up\", \"sign up\", \"registered\", \"registration\", \"account created\", \"new user\"],\n    platformDefaults: {\n      meta: { eventName: \"CompleteRegistration\", standard: true },\n      googleAds: { category: \"Sign-up\" },\n      linkedin: { type: \"SIGN_UP\", verified: true },\n    },\n  },\n  {\n    key: \"add_to_cart\",\n    displayName: \"Added to cart\",\n    meaning: \"Something went into the cart\",\n    stepClass: \"engaged\",\n    aliases: [\"added to cart\", \"add to cart\", \"cart\"],\n    platformDefaults: {\n      meta: { eventName: \"AddToCart\", standard: true },\n      googleAds: { category: \"Add to cart\" },\n      linkedin: { type: \"ADD_TO_CART\", verified: true },\n    },\n  },\n  {\n    key: \"checkout_started\",\n    displayName: \"Started checkout\",\n    meaning: \"The checkout began\",\n    stepClass: \"engaged\",\n    aliases: [\"started checkout\", \"checkout started\", \"checkout\", \"begin checkout\"],\n    platformDefaults: {\n      meta: { eventName: \"InitiateCheckout\", standard: true },\n      googleAds: { category: \"Begin checkout\" },\n      // Written from the documentation and never checked against the live\n      // enum, which is what `verified: false` is for — carried as a caveat\n      // rather than quietly resolved.\n      linkedin: { type: \"START_CHECKOUT\", verified: false, fallback: \"OTHER\" },\n    },\n  },\n  {\n    key: \"trial_started\",\n    displayName: \"Trial started\",\n    meaning: \"A free trial began\",\n    stepClass: \"engaged\",\n    classNote: \"A trial is use, not payment — engaged, never customer.\",\n    aliases: [\"trial\", \"trial started\", \"free trial\", \"in trial\"],\n    platformDefaults: {\n      meta: { eventName: \"StartTrial\", standard: true },\n      googleAds: { category: \"Sign-up\" },\n      linkedin: { type: \"OTHER\", verified: true },\n    },\n  },\n  {\n    key: \"qualified_lead\",\n    displayName: \"Qualified lead\",\n    meaning: \"The lead matches who you sell to\",\n    stepClass: \"engaged\",\n    aliases: [\"qualified lead\", \"qualified\", \"mql\", \"sql\", \"sales qualified lead\", \"marketing qualified lead\"],\n    platformDefaults: {\n      meta: { eventName: \"QualifiedLead\", standard: false },\n      googleAds: { category: \"Qualified lead\" },\n      linkedin: { type: \"QUALIFIED_LEAD\", verified: true },\n    },\n  },\n  {\n    key: \"contacted\",\n    displayName: \"Contacted\",\n    meaning: \"Your team reached out\",\n    stepClass: \"engaged\",\n    classNote: \"Engaged even though the move came from the seller: it is a real forward interaction.\",\n    aliases: [\"contacted\", \"contact\", \"outreach\", \"follow up\", \"first contact\", \"attempting contact\"],\n    platformDefaults: {\n      meta: { eventName: \"Contact\", standard: true },\n      googleAds: { category: \"Contact\" },\n      linkedin: { type: \"CONTACT\", verified: true },\n    },\n  },\n  {\n    key: \"meeting_scheduled\",\n    displayName: \"Meeting booked\",\n    meaning: \"A meeting is on the calendar\",\n    stepClass: \"engaged\",\n    aliases: [\n      \"meeting booked\",\n      \"meeting scheduled\",\n      \"demo scheduled\",\n      \"demo booked\",\n      \"appointment booked\",\n      \"call booked\",\n    ],\n    platformDefaults: {\n      meta: { eventName: \"Schedule\", standard: true },\n      googleAds: { category: \"Book appointment\" },\n      // LinkedIn has SCHEDULE and BOOK_APPOINTMENT separately; the second is the\n      // one that means a reservation.\n      linkedin: { type: \"BOOK_APPOINTMENT\", verified: true },\n    },\n  },\n  {\n    key: \"meeting_held\",\n    displayName: \"Meeting held\",\n    meaning: \"The meeting actually happened — kept apart from booking because no-show is a real number\",\n    stepClass: \"engaged\",\n    aliases: [\"meeting held\", \"meeting done\", \"demo held\", \"demo done\", \"demo completed\", \"call held\"],\n    platformDefaults: {\n      meta: { eventName: \"MeetingHeld\", standard: false },\n      googleAds: { category: \"Other\" },\n      linkedin: { type: \"OTHER\", verified: true },\n    },\n  },\n  {\n    key: \"opportunity\",\n    displayName: \"Opportunity open\",\n    meaning: \"A deal is open — send the estimated value if you have one\",\n    stepClass: \"engaged\",\n    classNote: \"A number behind an intention is still no money, so engaged rather than customer.\",\n    aliases: [\"opportunity\", \"proposal sent\", \"proposal\", \"negotiation\", \"in negotiation\", \"quote sent\", \"deal open\"],\n    platformDefaults: {\n      meta: { eventName: \"Opportunity\", standard: false },\n      googleAds: { category: \"Request quote\" },\n      linkedin: { type: \"REQUEST_QUOTE\", verified: true },\n    },\n  },\n  {\n    key: \"won\",\n    displayName: \"Deal won\",\n    meaning: \"The deal closed — the amount is required here\",\n    stepClass: \"customer\",\n    aliases: [\"won\", \"closed won\", \"deal won\", \"purchase\", \"sale\"],\n    platformDefaults: {\n      meta: { eventName: \"Purchase\", standard: true },\n      // Which of the two depends on whether the company reports a revenue\n      // amount. It is a per-company answer, so it stays a fork, not a constant.\n      googleAds: { category: \"Purchase\", alternative: \"Converted lead\" },\n      linkedin: { type: \"PURCHASE\", verified: true },\n    },\n  },\n  {\n    key: \"subscribed\",\n    displayName: \"Subscription started\",\n    meaning: \"A paying subscription began — the amount is the recurring one\",\n    stepClass: \"customer\",\n    classNote: \"Customer, not repeat: it is the first money. Repeat is what happens after — see the renewed template.\",\n    aliases: [\"subscribed\", \"subscription started\", \"new subscription\", \"paying\"],\n    platformDefaults: {\n      meta: { eventName: \"Subscribe\", standard: true },\n      googleAds: { category: \"Purchase\" },\n      linkedin: { type: \"PURCHASE\", verified: true },\n    },\n  },\n  {\n    key: \"renewed\",\n    displayName: \"Subscription renewed\",\n    meaning: \"An existing customer paid again or expanded — the amount is what they paid this time\",\n    stepClass: \"repeat\",\n    classNote:\n      \"The smallest honest member of `repeat`. Without it every SaaS funnel drawn from this library ends at `subscribed` and the stage has nothing to hold. The recurring lifecycle beyond renewal — upgrades, churn, refunds — is a bigger conversation than a template.\",\n    aliases: [\"renewed\", \"renewal\", \"subscription renewed\", \"expansion\", \"upsell\"],\n    platformDefaults: {\n      meta: { eventName: \"Renewed\", standard: false },\n      googleAds: { category: \"Purchase\" },\n      linkedin: { type: \"PURCHASE\", verified: true },\n    },\n  },\n  {\n    key: \"application_submitted\",\n    displayName: \"Application submitted\",\n    meaning: \"Someone submitted an application — a course, a policy, a credit line\",\n    stepClass: \"engaged\",\n    classNote: \"For education, events, fintech and insurance. Strong intent, no money yet.\",\n    aliases: [\"application submitted\", \"application\", \"applied\", \"application received\"],\n    platformDefaults: {\n      meta: { eventName: \"SubmitApplication\", standard: true },\n      googleAds: { category: \"Submit lead form\" },\n      linkedin: { type: \"SUBMIT_APPLICATION\", verified: true },\n    },\n  },\n  {\n    key: \"lost\",\n    displayName: \"Lost\",\n    meaning: \"It did not go ahead — the deal fell through, or the lead was never a fit\",\n    stepClass: \"lost\",\n    classNote:\n      \"Terminal and never sent anywhere. It can happen at any depth, which is why the order check leaves it alone.\",\n    aliases: [\n      \"lost\",\n      \"closed lost\",\n      \"deal lost\",\n      \"no budget\",\n      \"not interested\",\n      \"disqualified\",\n      \"unqualified\",\n      \"not a fit\",\n      \"spam\",\n      \"duplicate\",\n      \"junk\",\n    ],\n    platformDefaults: {},\n  },\n];\n\nconst TEMPLATES_BY_KEY: ReadonlyMap<string, FunnelStepTemplate> = new Map(\n  FUNNEL_STEP_TEMPLATES.map((template) => [template.key, template] as const),\n);\n\n/**\n * A name reduced to comparable words: lowercase, no separators, single spaces.\n * \"Won - Closed\", \"won_closed\" and \"WON / CLOSED\" all become the same two\n * words, which is the whole trick — every system writes the same moment its own\n * way.\n */\nfunction nameWords(value: string): string[] {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \" \")\n    .split(\" \")\n    .filter((word) => word !== \"\");\n}\n\n/** Whether `needle`'s words appear, in order and adjacent, inside `haystack`. */\nfunction containsWords(haystack: readonly string[], needle: readonly string[]): boolean {\n  if (needle.length === 0 || needle.length > haystack.length) {\n    return false;\n  }\n  for (let start = 0; start <= haystack.length - needle.length; start++) {\n    if (needle.every((word, offset) => haystack[start + offset] === word)) {\n      return true;\n    }\n  }\n  return false;\n}\n\ninterface NameCandidate {\n  stepKey: string;\n  phrases: readonly string[];\n}\n\n/** The longest phrase that matches wins — \"closed won\" beats a bare \"won\". */\nfunction bestCandidate(subject: readonly string[], candidates: readonly NameCandidate[]): string | null {\n  let best: string | null = null;\n  let bestLength = 0;\n  for (const candidate of candidates) {\n    for (const phrase of candidate.phrases) {\n      const words = nameWords(phrase);\n      const matches = containsWords(subject, words) || containsWords(words, subject);\n      if (matches && words.length > bestLength) {\n        best = candidate.stepKey;\n        bestLength = words.length;\n      }\n    }\n  }\n  return best;\n}\n\n/**\n * A guess at which of *this company's* steps some other system's name means.\n *\n * The company's own names are tried first, because a company that calls a step\n * \"Lead that fits\" has already said what its words are and no library should\n * talk over it. Only then do the template aliases get a turn, and only for\n * templates whose key the funnel actually contains — a suggestion has to be a\n * step the person can pick, so an alias of a step they never drew is no match\n * at all.\n *\n * `null` means \"no idea\", which is a fine answer: the picker just opens empty.\n */\nexport function suggestStepForName(\n  incomingName: string,\n  steps: readonly { key: string; displayName: string }[],\n  templates: readonly FunnelStepTemplate[] = FUNNEL_STEP_TEMPLATES,\n): string | null {\n  const subject = nameWords(incomingName);\n  if (subject.length === 0) {\n    return null;\n  }\n  const own = bestCandidate(\n    subject,\n    steps.map((step) => ({ stepKey: step.key, phrases: [step.displayName] })),\n  );\n  if (own !== null) {\n    return own;\n  }\n  const drawn = new Set(steps.map((step) => step.key));\n  return bestCandidate(\n    subject,\n    templates.filter((t) => drawn.has(t.key)).map((t) => ({ stepKey: t.key, phrases: t.aliases })),\n  );\n}\n\n/** `undefined` rather than a throw: a caller offering suggestions can simply offer fewer. */\nexport function stepTemplate(key: string): FunnelStepTemplate | undefined {\n  return TEMPLATES_BY_KEY.get(key);\n}\n\n/**\n * The preset a company picks once, at the cold start, to get a graph instead of\n * a blank canvas.\n *\n * **Two families, because that is who Baker sells to today.** There is no\n * e-commerce preset: no client runs that funnel and none is on the way, and a\n * preset nobody picks is a graph nobody checks. The e-commerce *templates* stay\n * in the library above — `add_to_cart`, `checkout_started`, `signed_up` are\n * offered one by one on the canvas like any other suggestion, and the day an\n * e-commerce client arrives the preset is four lines here, not new research.\n *\n * Within each family there are variants rather than one average funnel, because\n * the difference between the two B2B shapes — whether a human runs meetings —\n * changes almost every node, and a preset that splits the difference fits\n * neither.\n */\nexport const FUNNEL_PRESET_FAMILIES = [\"b2b\", \"saas\", \"ecommerce\"] as const;\nexport type FunnelPresetFamily = (typeof FUNNEL_PRESET_FAMILIES)[number];\n\nexport const FUNNEL_VERTICALS = [\n  \"b2b_sales\",\n  \"b2b_inbound\",\n  \"saas_self_serve\",\n  \"saas_sales_assisted\",\n  \"ecommerce_purchase\",\n] as const;\nexport type FunnelVertical = (typeof FUNNEL_VERTICALS)[number];\n\nexport interface FunnelPresetStep {\n  templateKey: string;\n  /** Predecessors, by template key. Empty means the funnel starts here. */\n  after: readonly string[];\n  /** Overrides the template's name where the vertical says it differently — \"Purchase\", not \"Deal won\". */\n  displayName?: string;\n}\n\nexport interface FunnelVerticalPreset {\n  vertical: FunnelVertical;\n  family: FunnelPresetFamily;\n  label: string;\n  /** One line for the picker, in the company's language rather than ours. */\n  description: string;\n  steps: readonly FunnelPresetStep[];\n}\n\n/**\n * Four small graphs — two shapes of B2B, two of SaaS — each the shortest funnel\n * of its kind that is still honest, not the fullest.\n *\n * Small on purpose. A preset is the first thing a company sees on the canvas,\n * and a fourteen-node suggestion invites deleting rather than editing; a step\n * that exists because a preset put it there and that nothing ever reaches shows\n * up as a gap in the funnel forever after.\n */\nexport const VERTICAL_PRESETS: readonly FunnelVerticalPreset[] = [\n  {\n    vertical: \"b2b_sales\",\n    family: \"b2b\",\n    label: \"B2B sales team\",\n    description: \"Leads a salesperson qualifies, meets, quotes and closes.\",\n    steps: [\n      { templateKey: \"lead\", after: [] },\n      { templateKey: \"qualified_lead\", after: [\"lead\"] },\n      { templateKey: \"meeting_scheduled\", after: [\"qualified_lead\"] },\n      // Booked and held stay apart because the gap between them is the no-show\n      // rate, which is a number this kind of team actually manages.\n      { templateKey: \"meeting_held\", after: [\"meeting_scheduled\"] },\n      { templateKey: \"opportunity\", after: [\"meeting_held\"] },\n      { templateKey: \"won\", after: [\"opportunity\"] },\n      // The end hangs off the earliest step at which it becomes possible; the\n      // order check ignores it anyway (`isOutOfOrder`), so the edge is there to\n      // be drawn, not to be enforced.\n      { templateKey: \"lost\", after: [\"opportunity\"] },\n    ],\n  },\n  {\n    vertical: \"b2b_inbound\",\n    family: \"b2b\",\n    label: \"B2B inbound, no meetings\",\n    description: \"Enquiries answered and closed without a meeting stage.\",\n    steps: [\n      { templateKey: \"lead\", after: [] },\n      { templateKey: \"qualified_lead\", after: [\"lead\"] },\n      { templateKey: \"contacted\", after: [\"qualified_lead\"] },\n      { templateKey: \"won\", after: [\"contacted\"] },\n      { templateKey: \"lost\", after: [\"contacted\"] },\n    ],\n  },\n  {\n    vertical: \"saas_self_serve\",\n    family: \"saas\",\n    label: \"SaaS, self-serve\",\n    description: \"People who sign up, trial the product and start paying on their own.\",\n    steps: [\n      { templateKey: \"signed_up\", after: [] },\n      { templateKey: \"trial_started\", after: [\"signed_up\"] },\n      { templateKey: \"subscribed\", after: [\"trial_started\"] },\n      { templateKey: \"renewed\", after: [\"subscribed\"] },\n      { templateKey: \"lost\", after: [\"trial_started\"], displayName: \"Trial expired\" },\n    ],\n  },\n  {\n    vertical: \"saas_sales_assisted\",\n    family: \"saas\",\n    label: \"SaaS, sales-assisted\",\n    description: \"Sign-ups and demo requests, with a salesperson in the middle of the bigger ones.\",\n    steps: [\n      // Two entry points, which is the whole reason `after` is a list: people\n      // arrive by signing up or by asking for a demo, never both, and a single\n      // position integer calls that ordinary path an anomaly.\n      { templateKey: \"signed_up\", after: [] },\n      { templateKey: \"lead\", after: [], displayName: \"Demo requested\" },\n      { templateKey: \"meeting_held\", after: [\"lead\"], displayName: \"Demo held\" },\n      { templateKey: \"trial_started\", after: [\"signed_up\", \"meeting_held\"] },\n      { templateKey: \"subscribed\", after: [\"trial_started\", \"meeting_held\"] },\n      { templateKey: \"renewed\", after: [\"subscribed\"] },\n    ],\n  },\n  {\n    vertical: \"ecommerce_purchase\",\n    family: \"ecommerce\",\n    label: \"Online shop\",\n    description: \"People who browse, fill a basket, check out and come back for a second order.\",\n    steps: [\n      { templateKey: \"saw_offer\", after: [], displayName: \"Viewed a product\" },\n      { templateKey: \"add_to_cart\", after: [\"saw_offer\"] },\n      { templateKey: \"checkout_started\", after: [\"add_to_cart\"] },\n      // A shop's \"customer\" is the order, and its \"repeat\" is the next one —\n      // the same two stages every other preset ends on, in a shop's words.\n      { templateKey: \"won\", after: [\"checkout_started\"], displayName: \"Order placed\" },\n      { templateKey: \"renewed\", after: [\"won\"], displayName: \"Ordered again\" },\n    ],\n  },\n];\n\n/**\n * The funnel every company starts with.\n *\n * Every company has a funnel from the day it exists — \"no funnel\" was a real\n * state, and it meant every \"how far did they get\" question had no answer\n * until somebody drew one. The default is the smallest honest journey: seeing\n * the offer, becoming a lead, becoming a customer. The first step listens for\n * any landing being viewed, so it counts from the first visit; the other two\n * start unwired and the canvas says so, because what a lead IS is the\n * company's to say.\n */\nexport function defaultFunnelSteps(): FunnelStepDefinition[] {\n  return [\n    {\n      key: \"visited\",\n      displayName: \"Visited\",\n      stepClass: \"visited\",\n      after: [],\n      triggers: [{ id: \"t1\", kind: \"any_landing\" }],\n    },\n    { key: \"lead\", displayName: \"Became a lead\", stepClass: \"lead\", after: [\"visited\"], triggers: [] },\n    { key: \"customer\", displayName: \"Became a customer\", stepClass: \"customer\", after: [\"lead\"], triggers: [] },\n  ];\n}\n\nexport function verticalPreset(vertical: FunnelVertical): FunnelVerticalPreset | undefined {\n  return VERTICAL_PRESETS.find((preset) => preset.vertical === vertical);\n}\n\n/**\n * A template turned into a real step of a company's funnel.\n *\n * The template stops existing at this point: what comes out is an ordinary\n * `FunnelStepDefinition` the company owns and can rename, reclassify or rewire,\n * with no link back. That is what makes this a suggestion library and not a\n * second schema.\n */\nexport function stepFromTemplate(\n  template: FunnelStepTemplate,\n  after: readonly string[],\n  displayName?: string,\n): FunnelStepDefinition {\n  return {\n    key: template.key,\n    displayName: displayName ?? template.displayName,\n    stepClass: template.stepClass,\n    after: [...after],\n    // A template says what a moment IS, never which of this company's events\n    // announces it — that is a per-company answer, and prefilling a guess would\n    // make a step look wired when it advances nobody.\n    triggers: [],\n  };\n}\n\n/**\n * The steps a preset produces, ready to hand to `validateDefinition` or draw.\n *\n * A preset step whose template does not exist is dropped rather than faked: the\n * pair is checked by a test, so a miss here is a bug in this file and a\n * half-invented step would hide it.\n */\nexport function presetDefinition(preset: FunnelVerticalPreset): FunnelStepDefinition[] {\n  return preset.steps.flatMap((step) => {\n    const template = stepTemplate(step.templateKey);\n    return template ? [stepFromTemplate(template, step.after, step.displayName)] : [];\n  });\n}\n","/**\n * The request and response `baker funnel` and its Convex route both speak.\n *\n * One schema, used by both sides, because the funnel is the one payload in this\n * feature that is a graph rather than a list of fields: a shape the CLI and the\n * backend agreed on separately would disagree about a predecessor naming a step\n * that does not exist, and that disagreement is invisible until a client's\n * funnel comes back drawn wrong.\n */\n\nimport { z } from \"zod\";\nimport { FUNNEL_VERTICALS } from \"./stepTemplates\";\nimport { FUNNEL_STEP_CLASSES } from \"./vocabulary\";\n\n/** How many steps one funnel may have. */\nconst MAX_STEPS = 40;\n/** How many triggers one step may have. */\nconst MAX_PER_STEP = 20;\n\n/**\n * One trigger: an event, by its key, a landing page being viewed, or any\n * landing being viewed.\n */\nexport const funnelTriggerSchema = z.discriminatedUnion(\"kind\", [\n  z.object({\n    id: z.string().min(1).max(64),\n    kind: z.literal(\"event\"),\n    /** The event's key, from `--moments`: `form:…`, `submit:…`, `page:…`, `exit:…`. */\n    eventKey: z.string().min(1).max(320),\n  }),\n  z.object({\n    id: z.string().min(1).max(64),\n    kind: z.literal(\"landing\"),\n    /** The landing's internal id — what the page stamps on its rows, never its slug. */\n    landingId: z.string().min(1).max(120),\n  }),\n  /** Any landing being viewed — what a funnel's first step usually listens for. */\n  z.object({\n    id: z.string().min(1).max(64),\n    kind: z.literal(\"any_landing\"),\n  }),\n]);\n\nexport const funnelStepSchema = z.object({\n  /** Lowercase letters, digits and underscores. Stable — renaming never changes it. */\n  key: z.string().min(1).max(64),\n  /** The client's own words for this step. Shown everywhere; unconstrained. */\n  displayName: z.string().min(1).max(120),\n  stepClass: z.enum(FUNNEL_STEP_CLASSES),\n  /** Predecessor keys. Empty means people come in here. */\n  after: z.array(z.string().max(64)).max(MAX_STEPS).default([]),\n  /** What moves somebody onto this step. Any one of them is enough. */\n  triggers: z.array(funnelTriggerSchema).max(MAX_PER_STEP).default([]),\n});\nexport type FunnelStepWire = z.infer<typeof funnelStepSchema>;\n\n/**\n * With none of `steps`, `preset`, `step`, `removeStep`, `addTrigger` and\n * `removeTrigger` this is a read, which is what makes `baker funnel` with no\n * flags show the funnel rather than erroring.\n *\n * `steps` restates the WHOLE funnel, and the review screen shows the funnel\n * the client will get rather than a set of edits whose result has to be\n * computed. `step` and `removeStep` change one step and leave the rest as it\n * stands — the door for an agent that wants to add a stage without restating\n * six others, because a restatement that forgot one removed it. Whichever\n * door is used, the response names every step the proposal dropped.\n */\nexport const funnelRequestSchema = z.object({\n  steps: z.array(funnelStepSchema).max(MAX_STEPS).optional(),\n  /** One step, added or replaced by its key. Everything else is untouched. */\n  step: funnelStepSchema.optional(),\n  /** One step taken out by key; whatever came after it moves up to whatever came before it. */\n  removeStep: z.string().min(1).max(64).optional(),\n  /**\n   * ONE way in added to a step, leaving the rest of that step alone.\n   *\n   * `step` takes a whole step, so adding a way in through it means restating\n   * the step's name, stage, `after[]` and every trigger it already had — and a\n   * trigger left out of that restatement is silently removed. This is the door\n   * for the thing that is actually being asked (\"this Form's booking should\n   * count here\"), and it cannot drop anything.\n   */\n  addTrigger: z.object({ stepKey: z.string().min(1).max(64), eventKey: z.string().min(1).max(320) }).optional(),\n  /** ONE way in taken off a step, by the event key it listens for. */\n  removeTrigger: z.object({ stepKey: z.string().min(1).max(64), eventKey: z.string().min(1).max(320) }).optional(),\n  /** One of the ready-made graphs, instead of stating steps. */\n  preset: z.enum(FUNNEL_VERTICALS).optional(),\n  /** Also return the suggestion library and the presets. */\n  templates: z.boolean().optional(),\n  /**\n   * Also return everything a trigger can name: every event this company's\n   * Forms, pages and systems have actually produced, its sources, and its\n   * landings. The list to pick a trigger FROM, so nobody has to guess.\n   */\n  moments: z.boolean().optional(),\n  /** How many days the counts beside each step cover. Default 30. */\n  days: z.number().int().min(1).max(400).optional(),\n  /**\n   * The Forms, by slug, the caller names itself when no step counts them —\n   * `baker funnel` reads its own workspace and names each with the key that\n   * places it. The backend leaves them out of its own hint, so no Form is\n   * named twice.\n   */\n  namedByCaller: z.array(z.string().min(1).max(200)).max(1000).optional(),\n});\nexport type FunnelRequest = z.infer<typeof funnelRequestSchema>;\n\n/**\n * What comes back is loosely typed on purpose.\n *\n * The response is read by an agent and by a person, never re-submitted, so a\n * strict mirror of the request would only make the route fail on a field the\n * store has and this file has not caught up with. The request is where the\n * shape is enforced.\n */\nexport const funnelResponseSchema = z.object({\n  ok: z.literal(true),\n  data: z.object({\n    /** The published version, or 0 when this company has never drawn a funnel. */\n    version: z.number(),\n    /** Whether `steps` is a proposal waiting on this chat's publish rather than what is live. */\n    staged: z.boolean(),\n    steps: z.array(\n      z.object({\n        key: z.string(),\n        displayName: z.string(),\n        stepClass: z.string(),\n        after: z.array(z.string()),\n        triggers: z.array(z.record(z.string(), z.unknown())),\n        /**\n         * Where the people who reach this step are sent: the sends of every\n         * system event among its triggers. Read-only here — a send belongs to\n         * the event and is set with `baker analytics sends`.\n         */\n        sends: z.array(\n          z.object({\n            id: z.string(),\n            eventKey: z.string(),\n            platform: z.string(),\n            event: z.string(),\n            /** What happened to it in the window, in one line. */\n            outcome: z.string().optional(),\n          }),\n        ),\n        /** How many people reached this step in the window. Counted in people, across visits and devices. */\n        people: z.number().optional(),\n        /** How many reached this step or any step after it. */\n        atLeast: z.number().optional(),\n        /** How many got as far as the step before it. Absent for a way in. */\n        before: z.number().optional(),\n        /** `atLeast / before`, 0–1. Absent where there is no before. */\n        share: z.number().optional(),\n        events: z.number().optional(),\n        money: z.record(z.string(), z.number()).optional(),\n      }),\n    ),\n    /** The window `people` and friends were counted over. */\n    window: z.object({ startDate: z.string(), endDate: z.string(), days: z.number() }).optional(),\n    /** The step that loses the most people, by key. Absent while nothing is lost. */\n    worstStep: z.string().optional(),\n    /**\n     * The steps this write took off the funnel, by key. Present on every write,\n     * empty when nothing was dropped — the answer to \"did my restatement forget\n     * one\", given in the same turn.\n     */\n    removed: z.array(z.string()).optional(),\n    /**\n     * What this company counts as page conversions, this chat's staged counts\n     * included, by event key and name. Here so a Form's ending can say it is\n     * already counted — the agent choosing a step's way in should use that\n     * same key — and outside `moments` because the plain read's hints say it too.\n     */\n    counted: z.array(z.object({ eventKey: z.string(), name: z.string() })).optional(),\n    /** Everything a trigger can name, when asked for with `moments`. */\n    moments: z\n      .object({\n        events: z.array(\n          z.object({\n            eventKey: z.string(),\n            /** `site` for a page or Form, `systems` for the client's own server, `both` when both sent it. */\n            origin: z.string().optional(),\n            /** The Form it belongs to, when it belongs to one. */\n            flowSlug: z.string().optional(),\n            nodeType: z.string().optional(),\n            events: z.number(),\n            sessions: z.number(),\n            /** The name it is counted under as a page conversion, when the company counts it. Informational. */\n            countedAs: z.string().optional(),\n            /**\n             * The step of the Form this happens on, in the Form's own words —\n             * never a node id. Present on a Form's ending read from the Form\n             * itself, which is the only place the name is known.\n             */\n            step: z.string().optional(),\n            /**\n             * `false` on an ending a Form raises natively but nobody has fired\n             * yet — derived from the Form, offered at zero, exactly as a\n             * Source is offered before its first send. Absent means it came\n             * from the event store and therefore happened.\n             */\n            seen: z.boolean().optional(),\n          }),\n        ),\n        /** The company's sources: a system of theirs that posts events to Baker, by the event name it raises. */\n        sources: z.array(z.object({ eventKey: z.string(), name: z.string(), status: z.string() })),\n        landings: z.array(z.object({ landingId: z.string(), title: z.string(), slug: z.string() })),\n      })\n      .optional(),\n    templates: z\n      .array(\n        z.object({\n          key: z.string(),\n          displayName: z.string(),\n          meaning: z.string(),\n          stepClass: z.string(),\n        }),\n      )\n      .optional(),\n    presets: z\n      .array(z.object({ vertical: z.string(), label: z.string(), description: z.string(), steps: z.array(z.string()) }))\n      .optional(),\n    /**\n     * What each stage means, the test to apply, and the same stage in three\n     * shapes of business.\n     *\n     * The stage is the one thing in a funnel a company does not invent, so it\n     * is the one thing the agent has to get right on the company's behalf —\n     * and \"engaged: did something real\" cannot settle whether a trial is\n     * engaged or customer. Same source as the dashboard's stage picker, so the\n     * two cannot teach it differently.\n     */\n    stages: z\n      .array(\n        z.object({\n          stepClass: z.string(),\n          title: z.string(),\n          meaning: z.string(),\n          test: z.string(),\n          examples: z.object({ shop: z.string(), selfServe: z.string(), salesLed: z.string() }),\n        }),\n      )\n      .optional(),\n  }),\n  hints: z.array(z.string()).optional(),\n});\nexport type FunnelResponse = z.infer<typeof funnelResponseSchema>;\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-JYOR334L.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-HSFPVQS5.js").then((m) => m.propertiesCommand),
+    config: () => import("./config-RHWFL6FM.js").then((m) => m.configCommand),
+    audit: () => import("./audit-F5SYOLIW.js").then((m) => m.auditCommand),
+    query: () => import("./query-RZNLSJZE.js").then((m) => m.queryCommand),
+    "key-event": () => import("./write-commands-NVWMNI2Q.js").then((m) => m.keyEventCommand),
+    "custom-dimension": () => import("./write-commands-NVWMNI2Q.js").then((m) => m.customDimensionCommand),
+    "custom-metric": () => import("./write-commands-NVWMNI2Q.js").then((m) => m.customMetricCommand),
+    "custom-event": () => import("./write-commands-NVWMNI2Q.js").then((m) => m.customEventCommand),
+    "data-retention": () => import("./write-commands-NVWMNI2Q.js").then((m) => m.dataRetentionCommand),
+    audience: () => import("./write-commands-NVWMNI2Q.js").then((m) => m.audienceCommand),
+    property: () => import("./write-commands-NVWMNI2Q.js").then((m) => m.propertyCommand),
+    "ads-link": () => import("./write-commands-NVWMNI2Q.js").then((m) => m.adsLinkCommand),
+    "enhanced-measurement": () => import("./write-commands-NVWMNI2Q.js").then((m) => m.enhancedMeasurementCommand),
+    draft: () => import("./draft-3QBNYCLN.js").then((m) => m.draftCommand)
+  }
+});
+export {
+  ga4Command
+};
+//# sourceMappingURL=ga4-JYOR334L.js.map

package/dist/generate-EO6M7ELE.js

@@ -0,0 +1,262 @@
+import {
+  IMAGE_MODEL_IDS,
+  IMAGE_QUALITIES,
+  IMAGE_SIZES,
+  resolveLibraryImageIds
+} from "./chunk-O2THKWAY.js";
+import {
+  awaitBatch,
+  batchHints,
+  projectBatch,
+  resolveMaxWaitMs,
+  waitingHint
+} from "./chunk-RAVSEXEL.js";
+import {
+  failStudioCommand
+} from "./chunk-C7EABFTU.js";
+import "./chunk-DMEGESTD.js";
+import "./chunk-2AFIXLB2.js";
+import {
+  DEFAULT_IMAGE_GENERATE_MODEL,
+  MODEL_REGISTRY,
+  maxInputReferences
+} from "./chunk-CAMX6OHF.js";
+import "./chunk-VVS5TLDG.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/generate.ts
+import { defineCommand } from "citty";
+var MODEL_LIST = IMAGE_MODEL_IDS;
+var DEFAULT_MAX_WAIT_MS = 24e4;
+registerSchema({
+  command: "studio.generate",
+  description: "Start here to make an image. Opens a Studio batch: the images are ingested into the media library as they render and the whole batch shows up in the dashboard Studio for the client, labelled with this conversation. Default model google/gemini-3.1-flash-image \u2014 fast, reference editing, extreme aspect ratios. --reference is the biggest quality lever: pass library image ids, local file paths, and/or image URLs to ground the render in real imagery.",
+  args: {
+    prompt: {
+      type: "string",
+      description: "What to generate \u2014 full art direction, not a keyword. Length caps are per model (Recraft 10,000 characters, gpt-image 32,000, Gemini publishes none) and a --skill or --brand block counts toward them; `baker studio models` has the number.",
+      required: true
+    },
+    model: {
+      type: "string",
+      description: `Model (default google/gemini-3.1-flash-image). They accept genuinely different things \u2014 check with \`baker studio models\` rather than assuming. One of: ${MODEL_LIST.join(", ")}`,
+      required: false,
+      enum: MODEL_LIST
+    },
+    "aspect-ratio": {
+      type: "string",
+      // Snapped, not refused: ask for the ad shape you want and the backend
+      // moves it to the nearest one the chosen model renders (gpt-image-2 has no
+      // 4:5, so a 4:5 request becomes 3:4 rather than failing).
+      description: "Aspect ratio, e.g. 1:1 (default), 16:9, 9:16, 4:5, 3:2 \u2014 Gemini flash also does 1:4 / 8:1. Snapped to the nearest shape the chosen model renders, so ask for the ad format you want (4:5 on gpt-image-2 or Recraft becomes 3:4, neither renders it). Must be width:height.",
+      required: false
+    },
+    count: { type: "number", description: "Takes to render, 1-8 (default 1)", required: false, default: 1 },
+    avatar: {
+      type: "string",
+      description: "Cast one of the company's avatars by short name (e.g. marta). Grounds the render on their identity sheet and reuses their subject description verbatim \u2014 do this instead of passing the sheet through --reference, which skips both and leaves the batch unattributed. `baker avatars list` shows who there is.",
+      required: false
+    },
+    reference: {
+      type: "string",
+      description: "Comma-separated visual references, in order: library image ids, local file paths, and/or image URLs. Paths and URLs are added to the media library first, so the reference is reusable and the client can see what grounded the render. How many are allowed is per model \u2014 Gemini takes 14, gpt-image 16, Recraft exactly 1.",
+      required: false
+    },
+    skill: {
+      type: "string",
+      description: "Craft direction by id (run `baker studio skills`), e.g. product-pack-shot, ugc-selfie-hook",
+      required: false
+    },
+    brand: {
+      type: "boolean",
+      description: "Append the company palette and visual style. Off by default \u2014 you are writing the art direction yourself and a brand block appended after it fights what you just specified.",
+      required: false,
+      default: false
+    },
+    "image-size": {
+      type: "string",
+      // No default: left unset the provider picks the pixels from the ratio.
+      // gpt-image-2 has no resolution setting at all and REFUSES this flag.
+      description: `Output resolution \u2014 only on models that have one (gpt-image-2 and Recraft have none and REFUSE this). The tiers differ per model: Lite renders 1K only, Pro 1K-4K, Gemini flash also 0.5K. One of: ${IMAGE_SIZES.join(", ")}`,
+      required: false,
+      enum: IMAGE_SIZES
+    },
+    quality: {
+      type: "string",
+      description: `Rendering quality \u2014 the OpenAI models only; every Gemini tier and Recraft REFUSE it. One of: ${IMAGE_QUALITIES.join(", ")}`,
+      required: false,
+      enum: IMAGE_QUALITIES
+    },
+    strength: { type: "number", description: "Recraft vector only: vectorization strength 0-1", required: false },
+    "rgb-colors": {
+      type: "string",
+      description: 'Recraft only: JSON array of [r,g,b] palette triples, each channel a whole number 0-255, e.g. "[[10,10,10],[255,80,0]]"',
+      required: false
+    },
+    "bg-rgb": {
+      type: "string",
+      description: 'Recraft only: JSON [r,g,b] background colour, e.g. "[255,255,255]"',
+      required: false
+    },
+    wait: {
+      type: "string",
+      description: "Pass false to get the batch id back immediately instead of waiting for the takes",
+      required: false,
+      default: "true"
+    },
+    "max-wait": {
+      type: "number",
+      description: "Max ms to wait for the takes (default 240000). 0 returns the id immediately.",
+      required: false,
+      default: DEFAULT_MAX_WAIT_MS
+    },
+    full: { type: "boolean", description: "Include settings, references and attribution", required: false }
+  }
+});
+function parseJsonArg(raw, flag) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new ApiError("VALIDATION_ERROR", `--${flag} must be valid JSON (got: ${raw})`);
+  }
+}
+function referenceLimitFor(model) {
+  const chosen = model ?? DEFAULT_IMAGE_GENERATE_MODEL;
+  const max = maxInputReferences("image_generate", chosen);
+  if (max === void 0) return void 0;
+  const label = MODEL_REGISTRY.image_generate[chosen]?.label ?? chosen;
+  return {
+    max,
+    refuse: (count) => max === 1 ? `${label} takes exactly one reference image \u2014 you passed ${count}. Pick the one that matters, or switch to a model that reads several.` : `${label} takes up to ${max} reference images \u2014 you passed ${count}. Drop the weakest ones.`
+  };
+}
+async function effectiveModel(pinned, skillId, fetchSkills = () => apiGet("/api/studio/skills")) {
+  if (pinned || !skillId) return pinned;
+  try {
+    const { skills } = await fetchSkills();
+    return skills.find((skill) => skill.id === skillId)?.defaults.model;
+  } catch {
+    return void 0;
+  }
+}
+function buildGenerateBody(args, prompt) {
+  const body = { prompt };
+  if (args.model) body.model = args.model;
+  if (args["aspect-ratio"]) body.aspectRatio = args["aspect-ratio"];
+  if (args.count !== void 0 && args.count !== "") body.count = Number(args.count);
+  if (args.avatar) body.avatar = args.avatar;
+  if (args.skill) body.skillId = args.skill;
+  if (args.brand) body.useBrand = true;
+  if (args["image-size"]) body.imageSize = args["image-size"];
+  if (args.quality) body.quality = args.quality;
+  if (args.strength !== void 0 && args.strength !== "") body.strength = Number(args.strength);
+  if (args["rgb-colors"]) {
+    body.rgbColors = parseJsonArg(args["rgb-colors"], "rgb-colors");
+  }
+  if (args["bg-rgb"]) {
+    body.backgroundRgbColor = parseJsonArg(
+      args["bg-rgb"],
+      "bg-rgb"
+    );
+  }
+  return body;
+}
+var generateCommand = defineCommand({
+  meta: {
+    name: "generate",
+    description: "Start here to make an image. Renders 1-8 takes of one brief, ingests each into the media library as it lands, and shows the batch in the dashboard Studio next to the ones the client ran.\n\nModel choice: google/gemini-3.1-flash-image (default \u2014 fast, best at editing a reference and at extreme ratios), google/gemini-3-pro-image (highest fidelity, slower), openai/gpt-image-2 (photoreal and the cleanest in-image text \u2014 no --image-size, no 4:5 / 5:4), recraft/recraft-v4.1-pro-vector (vector/flat marks with palette control).\n\n--reference is the biggest quality lever there is: a real logo, product shot, Pinterest pin or sandbox screenshot beats any amount of adjectives.\n\nExamples:\n  baker studio generate 'matte black bottle on wet marble, hard studio light, 35mm' --aspect-ratio 3:2 --count 3\n  baker studio generate 'this bottle on a sunlit kitchen counter' --reference './src/brand/product.png,https://\u2026/kitchen.jpg'\n  baker studio generate 'founder-style selfie, kitchen background, natural light' --skill ugc-selfie-hook\n  baker studio generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'"
+  },
+  args: {
+    avatar: {
+      type: "string",
+      description: "Cast an avatar by short name \u2014 grounds the image on their identity sheet",
+      required: false
+    },
+    prompt: { type: "positional", description: "What to generate", required: false },
+    model: { type: "string", description: "Model id (default google/gemini-3.1-flash-image)", required: false },
+    "aspect-ratio": { type: "string", description: "Aspect ratio (default 1:1)", required: false },
+    count: { type: "string", description: "Takes to render, 1-8 (default 1)", required: false },
+    reference: {
+      type: "string",
+      description: "Comma-separated library image ids, local file paths, and/or image URLs",
+      required: false
+    },
+    skill: { type: "string", description: "Craft direction id (`baker studio skills`)", required: false },
+    brand: { type: "boolean", description: "Append the company palette and style", required: false },
+    "image-size": {
+      type: "string",
+      description: `Output resolution, models that have one only: ${IMAGE_SIZES.join(" | ")}`,
+      required: false
+    },
+    quality: {
+      type: "string",
+      description: `Rendering quality, models that honour it only: ${IMAGE_QUALITIES.join(" | ")}`,
+      required: false
+    },
+    strength: { type: "string", description: "Recraft vectorization strength 0-1", required: false },
+    "rgb-colors": { type: "string", description: "Recraft palette JSON", required: false },
+    "bg-rgb": { type: "string", description: "Recraft background JSON", required: false },
+    wait: { type: "string", description: "false to return the batch id immediately", required: false },
+    "max-wait": { type: "string", description: "Max ms to wait (default 240000, 0 = no wait)", required: false },
+    full: { type: "boolean", description: "Include settings, references and attribution", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const prompt = args.prompt;
+      if (!prompt) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "A prompt is required" } });
+        process.exit(1);
+      }
+      const body = buildGenerateBody(args, prompt);
+      if (args.reference) {
+        const model = await effectiveModel(body.model, body.skillId);
+        const { imageIds } = await resolveLibraryImageIds(args.reference, referenceLimitFor(model));
+        if (imageIds.length > 0) body.referenceImageIds = imageIds;
+      }
+      const start = await apiPost("/api/studio/generate", body);
+      const maxWaitMs = resolveMaxWaitMs(args.wait, args["max-wait"], DEFAULT_MAX_WAIT_MS);
+      if (maxWaitMs === 0) {
+        writeJson({
+          ok: true,
+          data: start,
+          hints: [`Rendering ${start.count} take(s). Read them with \`baker studio get ${start.generationId}\`.`]
+        });
+        return;
+      }
+      const outcome = await awaitBatch(start.generationId, maxWaitMs);
+      if (outcome.kind !== "settled") {
+        writeJson({
+          ok: true,
+          data: { ...start, status: "running" },
+          hints: [waitingHint(outcome, start.generationId, maxWaitMs)]
+        });
+        return;
+      }
+      writeJson({
+        ok: true,
+        data: projectBatch(outcome.generation, args.full === true),
+        hints: batchHints(outcome.generation)
+      });
+    } catch (error) {
+      failStudioCommand(error, { withFix: true });
+    }
+  }
+});
+export {
+  buildGenerateBody,
+  effectiveModel,
+  generateCommand,
+  referenceLimitFor
+};
+//# sourceMappingURL=generate-EO6M7ELE.js.map

package/dist/get-344XATNV.js

@@ -0,0 +1,56 @@
+import {
+  buildGetHints,
+  failApi,
+  failValidation
+} from "./chunk-FSLFQHWG.js";
+import "./chunk-IDYAVGCS.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-PCKVSSVT.js";
+import "./chunk-MCM3HMNZ.js";
+import "./chunk-UW36KPPH.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/get.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.get",
+  description: "Get a single action with tags, blockers, blocked-by, and active-chat info.",
+  args: {
+    id: { type: "string", description: "Action ID", required: true }
+  }
+});
+var getCommand = defineCommand({
+  meta: { name: "get", description: "Get a single action by ID. Example: baker actions get <action-id>" },
+  args: {
+    id: { type: "positional", description: "Action ID", required: false },
+    "action-id": { type: "string", description: "Action ID (alternative to positional)", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      const response = await apiPost("/api/actions/get", { actionId: id });
+      const hints = buildGetHints(response.data);
+      writeJson(hints.length > 0 ? { ...response, hints } : response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  getCommand
+};
+//# sourceMappingURL=get-344XATNV.js.map