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

package/dist/flows-3N4RPGSP.js

@@ -0,0 +1,247 @@
+import {
+  collectConfigStatus,
+  collectSideEffects,
+  listFlowSlugs,
+  readFlowTree,
+  readSettings,
+  redactTree,
+  requestFlowInputCall,
+  withSettings
+} from "./chunk-PY4FAOW6.js";
+import {
+  FLOW_AGENT_DESTINATION_KINDS,
+  driftRepairHint,
+  flowNodeTriggers
+} from "./chunk-MAGSNHYB.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/flows/index.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "flows.list",
+  description: "List the Forms (flows) in this workspace and how many confidential fields each still needs configured. Read-only.",
+  args: {}
+});
+registerSchema({
+  command: "flows.show",
+  description: "Show a Form's confidential fields and whether each is configured (secrets/connections/third-party resources), AND whether its destination has changed under it \u2014 never reveals secret values. Destination drift is the one problem a Form cannot show you itself: when a HubSpot field a Form maps is deleted, HubSpot refuses the WHOLE submission and the visitor still sees the thank-you screen, so every lead is lost silently. Run this before changing any Form. Each sealed destination says where it sends (recipients, subject, sheet) \u2014 never a credential. Author structure by editing the flow's _data.json; set destinations yourself with `baker flows connect` (email: --email/--subject); only a typed secret goes to the request_flow_input tool.",
+  args: {
+    slug: { type: "positional", description: "Form slug (folder under flows/)", required: true },
+    full: { type: "boolean", description: "Include the full flow tree (secret values redacted)", required: false }
+  }
+});
+function statusFor(slug) {
+  const tree = readFlowTree(slug);
+  const config = [];
+  collectConfigStatus(tree, config);
+  return config;
+}
+function pendingInputHints(slug, config) {
+  const pending = config.filter((row) => row.needsInput);
+  if (pending.length === 0) return [];
+  const calls = pending.slice(0, MAX_PENDING_HINTS).map((row) => `${row.kind}: ${requestFlowInputCall(slug, row)}`);
+  const rest = pending.length - calls.length;
+  return [
+    ...repeatedKindHints(slug, pending),
+    `${pending.length} item${pending.length === 1 ? "" : "s"} still unwired. Wire each yourself with the command below when you know which resource is meant; the card is the fallback, and its result carries the destination \u2014 read the names from there rather than looking them up again.`,
+    ...calls,
+    ...rest > 0 ? [`\u2026and ${rest} more \u2014 see \`config\` above.`] : []
+  ];
+}
+function repeatedKindHints(slug, pending) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const row of pending) counts.set(row.kind, (counts.get(row.kind) ?? 0) + 1);
+  return [...counts].flatMap(([kind, count]) => {
+    if (count < 2) return [];
+    if (kind === "hubspotForm") {
+      return [
+        `${count} hubspotForm side effects are unwired. When they all send to the same HubSpot form: baker flows connect ${slug} --all --hubspot-form <formId>.`
+      ];
+    }
+    if (!FLOW_AGENT_DESTINATION_KINDS.includes(kind)) return [];
+    return [
+      `${count} ${kind} items are unwired. When they share one destination: baker flows connect ${slug} --all --type ${kind} [--resource <id>].`
+    ];
+  });
+}
+var MAX_PENDING_HINTS = 6;
+function inertSideEffectHints(tree) {
+  const dead = collectSideEffects(tree).flatMap(({ node, sideEffect }) => {
+    const triggers = flowNodeTriggers(node.nodeData);
+    if (!triggers.known) return [];
+    const triggerId = String(sideEffect.triggerId ?? "");
+    if (triggers.available.includes(triggerId)) return [];
+    const where = `${String(sideEffect.id ?? sideEffect.type)} on "${String(node.name ?? node.id)}"`;
+    const raises = triggers.available.length > 0 ? `It raises: ${triggers.available.join(", ")}.` : triggers.why ?? "That step raises nothing.";
+    return [`${where} fires on \`${triggerId || "(none)"}\`, which that step never raises. ${raises}`];
+  });
+  if (dead.length === 0) return [];
+  return [
+    `${dead.length} side effect${dead.length === 1 ? " has" : "s have"} a triggerId their step never raises, so ${dead.length === 1 ? "it never runs" : "they never run"} \u2014 no error, nothing half-written, just nothing. A triggerId belongs to the STEP, not to the side-effect type.`,
+    ...dead.slice(0, MAX_PENDING_HINTS),
+    ...dead.length > MAX_PENDING_HINTS ? [`\u2026and ${dead.length - MAX_PENDING_HINTS} more.`] : [],
+    "Fix each by setting the id its own step raises: `baker flows schema node <nodeType>` lists them."
+  ];
+}
+function funnelPlacementHint(slug) {
+  return `Whether this Form moves anyone along the company funnel is not in _data.json either: \`baker funnel\` names every Form no step counts. If it names this one, place its ending on the step it moves people to \u2014 \`submit:${slug}\`, or its booking trigger, both listed by \`baker funnel --moments\` \u2014 with \`baker funnel --step\`, which replaces the step it names, so keep that step's other ways in.`;
+}
+async function readDrift(slug) {
+  try {
+    const response = await apiPost("/api/flows/drift", { slug });
+    return response.data;
+  } catch {
+    return null;
+  }
+}
+function driftHints(slug, drift) {
+  if (drift === null) {
+    return [
+      "Could not check whether this Form's destination has changed under it. Treat that as UNKNOWN, not as healthy \u2014 a deleted HubSpot field refuses every submission while the visitor still sees the thank-you screen."
+    ];
+  }
+  const forms = drift.forms.filter((form) => form.slug === slug);
+  if (forms.length === 0) {
+    return drift.checkedAt === null ? [
+      "This Form's destination has never been checked, so nothing here says it is healthy \u2014 only that nothing was compared."
+    ] : [];
+  }
+  return forms.flatMap((form) => {
+    const repair = driftRepairHint(slug, form.formGuid, form.deadFields, form.sideEffectId);
+    return [`DESTINATION DRIFT (${form.severity}): ${form.summary}`, ...repair === null ? [] : [repair]];
+  });
+}
+function displayName(slug) {
+  const tree = readFlowTree(slug);
+  const name = tree.displayName;
+  return typeof name === "string" && name.trim() ? name.trim() : slug;
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List Forms in this workspace with the count of confidential fields still needing setup. Example: baker flows list"
+  },
+  run: () => {
+    const flows = listFlowSlugs().map((slug) => ({
+      slug,
+      name: displayName(slug),
+      needsConfig: statusFor(slug).filter((c) => c.needsInput).length
+    }));
+    const pending = flows.filter((flow) => flow.needsConfig > 0);
+    writeJson({
+      ok: true,
+      data: { flows },
+      hints: [
+        ...pending.length > 0 ? [
+          `Still unwired: ${pending.map((flow) => `${flow.slug} (${flow.needsConfig})`).join(", ")}. \`baker flows show <slug>\` returns the command that wires each \u2014 most you run yourself.`
+        ] : [],
+        // "Set the conversions on the Forms" lands here first, and nothing in
+        // this family can do it — the conversion side effects it does offer
+        // fire a pixel and are not what any Baker report counts.
+        "Setting what a Form COUNTS is not in this family: a conversion is a named event held in Baker. `baker analytics conversions` lists what this company counts; `--flow <slug>` spells one Form's endings as keys you can count, traffic or no traffic."
+      ]
+    });
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show a Form's confidential fields and their configuration status (never secret values). Example: baker flows show contact"
+  },
+  args: {
+    slug: { type: "positional", description: "Form slug", required: true },
+    full: { type: "boolean", description: "Include the full flow tree (secret values redacted)" }
+  },
+  run: async ({ args }) => {
+    const slug = String(args.slug);
+    const tree = readFlowTree(slug);
+    const [drift, settings] = await Promise.all([readDrift(slug), readSettings(tree)]);
+    const config = withSettings(statusFor(slug), settings ?? {});
+    const response = {
+      slug,
+      name: displayName(slug),
+      config,
+      drift: drift === null ? null : drift.forms.filter((form) => form.slug === slug),
+      ...drift === null ? {} : { driftCheckedAt: drift.checkedAt },
+      ...args.full === true ? { tree: redactTree(tree) } : {}
+    };
+    writeJson({
+      ok: true,
+      data: response,
+      // Drift first, above everything. The other hints are about work still to
+      // do; this one is about leads already being lost, and it is the only
+      // thing here that is true of a Form that looks completely finished.
+      hints: [
+        ...driftHints(slug, drift),
+        ...inertSideEffectHints(tree),
+        ...pendingInputHints(slug, config),
+        // The question this command is asked — "is this Form wired up?" — has
+        // an answer that is not in this file at all. What a Form counts is a
+        // named event in Baker, and a Form can be perfectly configured, fire
+        // every pixel it has, and still report converting nobody.
+        `What this Form counts as a conversion is NOT in _data.json and not in any side effect here: it is a named event held in Baker. Read it, and this Form's own endings spelled as event keys, with \`baker analytics conversions --flow ${slug}\`.`,
+        funnelPlacementHint(slug)
+      ]
+    });
+  }
+});
+var flowsCommand = defineCommand({
+  meta: {
+    name: "flows",
+    description: `Read and shape this workspace's Forms (flows).
+
+Reads never reveal a secret value. Writes touch only the form's own _data.json \u2014 they stage structure, never a live system.
+
+Wire every destination yourself \u2014 no card for the user: an email (\`connect --email "a@x.com, b@x.com" --subject "New lead \u2014 Contact"\`; write the subject yourself), a webhook without a token (\`--url\`), and any connected platform once you know which resource is meant (\`baker flows options <kind>\` lists it; Calendly, SavvyCal, GoHighLevel steps; Google Sheets, Pipedrive, GoHighLevel, ActiveCampaign and HubSpot destinations; \`--same-as\` copies another Form's). A HubSpot step takes \`baker hubspot forms view <id> --as-node\`. \`show\` reads back where each destination sends; a credential is never shown.
+
+The request_flow_input tool (baker_ui MCP server) is only for what the user alone holds: a typed secret (a webhook token, Zapier, Crmble), a platform nobody connected, or several resources that could equally be meant.
+
+Examples:
+  baker flows list                                  # every Form + how many fields still need setup
+  baker flows show contact                          # one Form's confidential fields and their status
+  baker flows schema node customForm                # the shape of a step, before you author one
+  baker flows add-node contact --type text --name "Thanks"
+  baker flows add-side-effect contact --node <id> --type googleSpreadsheet
+  baker flows options calendly                      # what the connected account holds
+  baker flows connect contact --node book --resource <id>
+  baker flows connect contact --side-effect se-email-1 --email "ana@x.com, luis@x.com" --subject "New lead \u2014 Contact"
+  baker flows connect contact --side-effect se-hubspotForm-1 --hubspot-form <formId>   # --all: every unwired one
+  baker flows map contact --map A=name --map B=email --write
+Full guide: __tooling__/docs/tools/baker/flows.md`
+  },
+  subCommands: {
+    list: listCommand,
+    show: showCommand,
+    schema: () => import("./schema-5HZIAHY3.js").then((m) => m.schemaCommand),
+    "add-node": () => import("./add-MYPHHYC4.js").then((m) => m.addNodeCommand),
+    "add-side-effect": () => import("./add-MYPHHYC4.js").then((m) => m.addSideEffectCommand),
+    options: () => import("./options-FXND5P2W.js").then((m) => m.optionsCommand),
+    connect: () => import("./connect-VTDKGYP3.js").then((m) => m.connectCommand),
+    map: () => import("./map-7SHU5WCJ.js").then((m) => m.mapCommand),
+    normalize: () => import("./normalize-RP3D7BUT.js").then((m) => m.normalizeCommand)
+  },
+  // Bare `baker flows` lists the Forms. This must be `default`, not `run`: citty falls
+  // through to `run` after dispatching a subcommand, so a `run` here would also print
+  // the list on every `baker flows show <slug>`.
+  default: "list"
+});
+export {
+  driftHints,
+  flowsCommand,
+  funnelPlacementHint,
+  inertSideEffectHints
+};
+//# sourceMappingURL=flows-3N4RPGSP.js.map

package/dist/flows-3N4RPGSP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/flows/index.ts"],"sourcesContent":["import {\n  driftRepairHint,\n  FLOW_AGENT_DESTINATION_KINDS,\n  type FlowConfigStatus,\n  type FlowDrift,\n  type FlowSummary,\n  type FlowsDriftResponse,\n  type FlowsShowResponse,\n  flowNodeTriggers,\n} from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport {\n  collectConfigStatus,\n  collectSideEffects,\n  listFlowSlugs,\n  readFlowTree,\n  readSettings,\n  redactTree,\n  requestFlowInputCall,\n  withSettings,\n} from \"./shared.ts\";\n\nregisterSchema({\n  command: \"flows.list\",\n  description:\n    \"List the Forms (flows) in this workspace and how many confidential fields each still needs configured. Read-only.\",\n  args: {},\n});\n\nregisterSchema({\n  command: \"flows.show\",\n  description:\n    \"Show a Form's confidential fields and whether each is configured (secrets/connections/third-party resources), AND whether its destination has changed under it — never reveals secret values. Destination drift is the one problem a Form cannot show you itself: when a HubSpot field a Form maps is deleted, HubSpot refuses the WHOLE submission and the visitor still sees the thank-you screen, so every lead is lost silently. Run this before changing any Form. Each sealed destination says where it sends (recipients, subject, sheet) — never a credential. Author structure by editing the flow's _data.json; set destinations yourself with `baker flows connect` (email: --email/--subject); only a typed secret goes to the request_flow_input tool.\",\n  args: {\n    slug: { type: \"positional\", description: \"Form slug (folder under flows/)\", required: true },\n    full: { type: \"boolean\", description: \"Include the full flow tree (secret values redacted)\", required: false },\n  },\n});\n\nfunction statusFor(slug: string): FlowConfigStatus[] {\n  const tree = readFlowTree(slug);\n  const config: FlowConfigStatus[] = [];\n  collectConfigStatus(tree, config);\n  return config;\n}\n\n/**\n * The calls that close out everything this form is still waiting on.\n *\n * `show` is the command an agent runs to answer \"is this form wired up?\", and\n * it answered with `needsInput: true` and nothing else — leaving the agent to\n * work out that a tool exists, which tool, and how to address the exact node or\n * side effect. The whole point of asking is to find out what to do next, so the\n * answer is the call itself.\n */\nfunction pendingInputHints(slug: string, config: FlowConfigStatus[]): string[] {\n  const pending = config.filter((row) => row.needsInput);\n  if (pending.length === 0) return [];\n  const calls = pending.slice(0, MAX_PENDING_HINTS).map((row) => `${row.kind}: ${requestFlowInputCall(slug, row)}`);\n  const rest = pending.length - calls.length;\n  return [\n    ...repeatedKindHints(slug, pending),\n    `${pending.length} item${pending.length === 1 ? \"\" : \"s\"} still unwired. Wire each yourself with the command below when you know which resource is meant; the card is the fallback, and its result carries the destination — read the names from there rather than looking them up again.`,\n    ...calls,\n    ...(rest > 0 ? [`…and ${rest} more — see \\`config\\` above.`] : []),\n  ];\n}\n\n/**\n * Several unwired items of one kind usually share one destination — chat\n * r57ed43j had 24 HubSpot side effects all sending to the same form — so\n * name the call that fills them all at once.\n */\nfunction repeatedKindHints(slug: string, pending: FlowConfigStatus[]): string[] {\n  const counts = new Map<string, number>();\n  for (const row of pending) counts.set(row.kind, (counts.get(row.kind) ?? 0) + 1);\n  return [...counts].flatMap(([kind, count]) => {\n    if (count < 2) return [];\n    if (kind === \"hubspotForm\") {\n      return [\n        `${count} hubspotForm side effects are unwired. When they all send to the same HubSpot form: baker flows connect ${slug} --all --hubspot-form <formId>.`,\n      ];\n    }\n    if (!(FLOW_AGENT_DESTINATION_KINDS as readonly string[]).includes(kind)) return [];\n    return [\n      `${count} ${kind} items are unwired. When they share one destination: baker flows connect ${slug} --all --type ${kind} [--resource <id>].`,\n    ];\n  });\n}\n\n/** Enough for any real form; the cap only stops a pathological tree flooding the response. */\nconst MAX_PENDING_HINTS = 6;\n\n/**\n * Side effects wired to a moment their own step never raises.\n *\n * `fireSideEffects` filters on `triggerId` equality, so one that does not match\n * is inert: written, valid, green on every check in the repo, and it never\n * runs. Nothing else in the toolchain looks at the pair — `validate-flow.mjs`\n * only checks the key is present and `validate-flow-schema.mjs` does not read\n * it at all — so a form can report \"fully configured\" while a side effect on it\n * has never fired once. This is the one command that is asked whether a form is\n * wired up, so it is the one that has to say.\n *\n * Silent about a node type the trigger table does not cover: no opinion is the\n * honest answer there, and a false \"this never fires\" on a working form would\n * cost more than the warning is worth.\n */\nexport function inertSideEffectHints(tree: Record<string, unknown>): string[] {\n  const dead = collectSideEffects(tree).flatMap(({ node, sideEffect }) => {\n    const triggers = flowNodeTriggers(node.nodeData);\n    if (!triggers.known) return [];\n    const triggerId = String(sideEffect.triggerId ?? \"\");\n    if (triggers.available.includes(triggerId)) return [];\n    const where = `${String(sideEffect.id ?? sideEffect.type)} on \"${String(node.name ?? node.id)}\"`;\n    const raises =\n      triggers.available.length > 0\n        ? `It raises: ${triggers.available.join(\", \")}.`\n        : (triggers.why ?? \"That step raises nothing.\");\n    return [`${where} fires on \\`${triggerId || \"(none)\"}\\`, which that step never raises. ${raises}`];\n  });\n\n  if (dead.length === 0) return [];\n  return [\n    `${dead.length} side effect${dead.length === 1 ? \" has\" : \"s have\"} a triggerId their step never raises, so ${dead.length === 1 ? \"it never runs\" : \"they never run\"} — no error, nothing half-written, just nothing. A triggerId belongs to the STEP, not to the side-effect type.`,\n    ...dead.slice(0, MAX_PENDING_HINTS),\n    ...(dead.length > MAX_PENDING_HINTS ? [`…and ${dead.length - MAX_PENDING_HINTS} more.`] : []),\n    \"Fix each by setting the id its own step raises: `baker flows schema node <nodeType>` lists them.\",\n  ];\n}\n\n/**\n * Where the company funnel stands on this Form.\n *\n * A Form moves nobody along the company funnel until a step names one of its\n * endings, and nothing places it for the agent — so a Form that is configured,\n * fires every pixel and counts its conversions can still leave \"Became a lead\"\n * at zero. `show` reads only the local file and cannot tell whether a step\n * names it; `baker funnel` can, so the hint names that read and the write.\n */\nexport function funnelPlacementHint(slug: string): string {\n  return `Whether this Form moves anyone along the company funnel is not in _data.json either: \\`baker funnel\\` names every Form no step counts. If it names this one, place its ending on the step it moves people to — \\`submit:${slug}\\`, or its booking trigger, both listed by \\`baker funnel --moments\\` — with \\`baker funnel --step\\`, which replaces the step it names, so keep that step's other ways in.`;\n}\n\n/**\n * What this Form's destination has changed under it, asked of Baker.\n *\n * A read the Company Workspace cannot do for itself twice over: the findings\n * live on the `flows` row, and the HubSpot form id a repair needs is inside an\n * encrypted config. Before this, detection had no reader in the Runtime at all\n * — 47 live findings across 11 Forms, and an agent editing one of those Forms\n * could not see a single one.\n *\n * A failure returns null rather than `[]`. They are different answers and\n * collapsing them would report a Form healthy on the strength of a network\n * error, which is exactly the silence the drift check exists to break.\n */\nasync function readDrift(slug: string): Promise<FlowsDriftResponse | null> {\n  try {\n    const response = await apiPost<{ ok: true; data: FlowsDriftResponse }>(\"/api/flows/drift\", { slug });\n    return response.data;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Drift said to an agent: what is wrong, and the command that fixes it.\n *\n * The summary comes from `@baker/api`, which the dashboard badge reads too, so\n * this and the badge cannot come apart about whether a Form is healthy. What is\n * added here is the half that is the CLI's: the repair, spelled as a command\n * line, because an agent that has to go and work out `--prune-missing` for\n * itself will instead reach for `--replace` and delete the mappings that still\n * work.\n */\nexport function driftHints(slug: string, drift: FlowsDriftResponse | null): string[] {\n  if (drift === null) {\n    return [\n      \"Could not check whether this Form's destination has changed under it. Treat that as UNKNOWN, not as healthy — a deleted HubSpot field refuses every submission while the visitor still sees the thank-you screen.\",\n    ];\n  }\n\n  const forms = drift.forms.filter((form) => form.slug === slug);\n  if (forms.length === 0) {\n    return drift.checkedAt === null\n      ? [\n          \"This Form's destination has never been checked, so nothing here says it is healthy — only that nothing was compared.\",\n        ]\n      : [];\n  }\n\n  return forms.flatMap((form: FlowDrift) => {\n    const repair = driftRepairHint(slug, form.formGuid, form.deadFields, form.sideEffectId);\n    return [`DESTINATION DRIFT (${form.severity}): ${form.summary}`, ...(repair === null ? [] : [repair])];\n  });\n}\n\nfunction displayName(slug: string): string {\n  const tree = readFlowTree(slug);\n  const name = tree.displayName;\n  return typeof name === \"string\" && name.trim() ? name.trim() : slug;\n}\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List Forms in this workspace with the count of confidential fields still needing setup. Example: baker flows list\",\n  },\n  run: () => {\n    const flows: FlowSummary[] = listFlowSlugs().map((slug) => ({\n      slug,\n      name: displayName(slug),\n      needsConfig: statusFor(slug).filter((c) => c.needsInput).length,\n    }));\n    const pending = flows.filter((flow) => flow.needsConfig > 0);\n    writeJson({\n      ok: true,\n      data: { flows },\n      hints: [\n        ...(pending.length > 0\n          ? [\n              `Still unwired: ${pending.map((flow) => `${flow.slug} (${flow.needsConfig})`).join(\", \")}. \\`baker flows show <slug>\\` returns the command that wires each — most you run yourself.`,\n            ]\n          : []),\n        // \"Set the conversions on the Forms\" lands here first, and nothing in\n        // this family can do it — the conversion side effects it does offer\n        // fire a pixel and are not what any Baker report counts.\n        \"Setting what a Form COUNTS is not in this family: a conversion is a named event held in Baker. `baker analytics conversions` lists what this company counts; `--flow <slug>` spells one Form's endings as keys you can count, traffic or no traffic.\",\n      ],\n    });\n  },\n});\n\nconst showCommand = defineCommand({\n  meta: {\n    name: \"show\",\n    description:\n      \"Show a Form's confidential fields and their configuration status (never secret values). Example: baker flows show contact\",\n  },\n  args: {\n    slug: { type: \"positional\", description: \"Form slug\", required: true },\n    full: { type: \"boolean\", description: \"Include the full flow tree (secret values redacted)\" },\n  },\n  run: async ({ args }) => {\n    const slug = String(args.slug);\n    const tree = readFlowTree(slug);\n    const [drift, settings] = await Promise.all([readDrift(slug), readSettings(tree)]);\n    const config = withSettings(statusFor(slug), settings ?? {});\n    const response: FlowsShowResponse = {\n      slug,\n      name: displayName(slug),\n      config,\n      drift: drift === null ? null : drift.forms.filter((form) => form.slug === slug),\n      ...(drift === null ? {} : { driftCheckedAt: drift.checkedAt }),\n      ...(args.full === true ? { tree: redactTree(tree) } : {}),\n    };\n    writeJson({\n      ok: true,\n      data: response,\n      // Drift first, above everything. The other hints are about work still to\n      // do; this one is about leads already being lost, and it is the only\n      // thing here that is true of a Form that looks completely finished.\n      hints: [\n        ...driftHints(slug, drift),\n        ...inertSideEffectHints(tree),\n        ...pendingInputHints(slug, config),\n        // The question this command is asked — \"is this Form wired up?\" — has\n        // an answer that is not in this file at all. What a Form counts is a\n        // named event in Baker, and a Form can be perfectly configured, fire\n        // every pixel it has, and still report converting nobody.\n        `What this Form counts as a conversion is NOT in _data.json and not in any side effect here: it is a named event held in Baker. Read it, and this Form's own endings spelled as event keys, with \\`baker analytics conversions --flow ${slug}\\`.`,\n        funnelPlacementHint(slug),\n      ],\n    });\n  },\n});\n\nexport const flowsCommand = defineCommand({\n  meta: {\n    name: \"flows\",\n    description: `Read and shape this workspace's Forms (flows).\n\nReads never reveal a secret value. Writes touch only the form's own _data.json — they stage structure, never a live system.\n\nWire every destination yourself — no card for the user: an email (\\`connect --email \"a@x.com, b@x.com\" --subject \"New lead — Contact\"\\`; write the subject yourself), a webhook without a token (\\`--url\\`), and any connected platform once you know which resource is meant (\\`baker flows options <kind>\\` lists it; Calendly, SavvyCal, GoHighLevel steps; Google Sheets, Pipedrive, GoHighLevel, ActiveCampaign and HubSpot destinations; \\`--same-as\\` copies another Form's). A HubSpot step takes \\`baker hubspot forms view <id> --as-node\\`. \\`show\\` reads back where each destination sends; a credential is never shown.\n\nThe request_flow_input tool (baker_ui MCP server) is only for what the user alone holds: a typed secret (a webhook token, Zapier, Crmble), a platform nobody connected, or several resources that could equally be meant.\n\nExamples:\n  baker flows list                                  # every Form + how many fields still need setup\n  baker flows show contact                          # one Form's confidential fields and their status\n  baker flows schema node customForm                # the shape of a step, before you author one\n  baker flows add-node contact --type text --name \"Thanks\"\n  baker flows add-side-effect contact --node <id> --type googleSpreadsheet\n  baker flows options calendly                      # what the connected account holds\n  baker flows connect contact --node book --resource <id>\n  baker flows connect contact --side-effect se-email-1 --email \"ana@x.com, luis@x.com\" --subject \"New lead — Contact\"\n  baker flows connect contact --side-effect se-hubspotForm-1 --hubspot-form <formId>   # --all: every unwired one\n  baker flows map contact --map A=name --map B=email --write\nFull guide: __tooling__/docs/tools/baker/flows.md`,\n  },\n  subCommands: {\n    list: listCommand,\n    show: showCommand,\n    schema: () => import(\"./schema.ts\").then((m) => m.schemaCommand),\n    \"add-node\": () => import(\"./add.ts\").then((m) => m.addNodeCommand),\n    \"add-side-effect\": () => import(\"./add.ts\").then((m) => m.addSideEffectCommand),\n    options: () => import(\"./options.ts\").then((m) => m.optionsCommand),\n    connect: () => import(\"./connect.ts\").then((m) => m.connectCommand),\n    map: () => import(\"./map.ts\").then((m) => m.mapCommand),\n    normalize: () => import(\"./normalize.ts\").then((m) => m.normalizeCommand),\n  },\n  // Bare `baker flows` lists the Forms. This must be `default`, not `run`: citty falls\n  // through to `run` after dispatching a subcommand, so a `run` here would also print\n  // the list on every `baker flows show <slug>`.\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}

package/dist/follow-BB5KUEXZ.js

@@ -0,0 +1,94 @@
+import {
+  PLATFORM_NAMES,
+  reportError
+} from "./chunk-ICJFL7DU.js";
+import {
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  brandAccountInput,
+  registerSchema,
+  writeJson
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/follow.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.follow",
+  description: "Follow a brand so ALL its ads join your library \u2014 every platform (Meta, LinkedIn, TikTok, Google Ads), every account it runs there (one Facebook page per market, each Google entity) and every country. Paste whatever you have: a website (best \u2014 finds every account it links), a brand name, or any profile / ad-library link. Already-in-corpus brands are subscribed instantly; new brands are queued for ingestion. Accounts only named like the brand come back as `suggestions` with a ready `add-accounts` command.",
+  args: {
+    input: {
+      type: "string",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    },
+    label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
+  }
+});
+function followHints(data) {
+  const hints = [];
+  if (data.status === "added") {
+    hints.push(
+      "This brand is new \u2014 we're adding every ad we can find across all platforms and countries. They appear as ingestion completes; check `baker winning-ads following`."
+    );
+  } else if (data.status === "ambiguous") {
+    hints.push(
+      "Multiple brands matched. Pick one from `candidates` and re-run `follow` with its exact website or link."
+    );
+  }
+  const suggestions = data.suggestions ?? [];
+  const names = suggestions.map((s) => `${s.name} (${PLATFORM_NAMES[s.platform]})`).join(", ");
+  if (data.status === "unconfirmed") {
+    const [first] = suggestions;
+    hints.push(
+      `Nothing followed yet: we found no account we're sure is this brand's, only accounts named like it: ${names}. Follow the brand's own with its link, e.g. baker winning-ads follow "${first ? brandAccountInput(first) : ""}", then add its other markets' accounts with \`add-accounts\`. Or retry with the brand's website.`
+    );
+    return hints;
+  }
+  if (data.advertiser && suggestions.length > 0) {
+    const inputs = suggestions.map(brandAccountInput).join(",");
+    hints.push(
+      `Also found accounts named like this brand, not tracked yet: ${names}. If they are the same brand (another country or language), track them with: baker winning-ads add-accounts ${data.advertiser.advertiser_id} "${inputs}" \u2014 drop any that belong to someone else.`
+    );
+  }
+  return hints.length > 0 ? hints : void 0;
+}
+var followCommand = defineCommand({
+  meta: {
+    name: "follow",
+    description: 'Follow a brand to track ALL its ads \u2014 every platform, every account and country. Paste a website (best), a brand name, or any profile/ad-library link. Example: baker winning-ads follow "barkibu.com"'
+  },
+  args: {
+    input: {
+      type: "positional",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    },
+    label: { type: "string", description: "Optional display label", required: false },
+    platform: {
+      type: "string",
+      description: "Ignored \u2014 every platform is searched. Kept so older commands still run.",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = { input: String(args.input) };
+      if (args.label) {
+        body.label = String(args.label);
+      }
+      const data = await apiPost("/api/ad-library/follow", body);
+      writeJson({ ok: true, data, hints: followHints(data) });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  followCommand,
+  followHints
+};
+//# sourceMappingURL=follow-BB5KUEXZ.js.map

package/dist/follow-BB5KUEXZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/follow.ts"],"sourcesContent":["import { brandAccountInput, type FollowResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { PLATFORM_NAMES, reportError } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"winning-ads.follow\",\n  description:\n    \"Follow a brand so ALL its ads join your library — every platform (Meta, LinkedIn, TikTok, Google Ads), every account it runs there (one Facebook page per market, each Google entity) and every country. Paste whatever you have: a website (best — finds every account it links), a brand name, or any profile / ad-library link. Already-in-corpus brands are subscribed instantly; new brands are queued for ingestion. Accounts only named like the brand come back as `suggestions` with a ready `add-accounts` command.\",\n  args: {\n    input: {\n      type: \"string\",\n      description: \"Website (best), brand name, or any profile/ad-library link\",\n      required: true,\n    },\n    label: { type: \"string\", description: \"Optional display label (defaults to the resolved name)\", required: false },\n  },\n});\n\n/**\n * What the agent reads after a follow: what is still loading, how to pick a\n * candidate, and every look-alike account as one ready `add-accounts` command\n * — tracking them is a judgement (another market's page, or a stranger's), so\n * it is offered, never done.\n */\nexport function followHints(data: FollowResponse): string[] | undefined {\n  const hints: string[] = [];\n  if (data.status === \"added\") {\n    hints.push(\n      \"This brand is new — we're adding every ad we can find across all platforms and countries. They appear as ingestion completes; check `baker winning-ads following`.\",\n    );\n  } else if (data.status === \"ambiguous\") {\n    hints.push(\n      \"Multiple brands matched. Pick one from `candidates` and re-run `follow` with its exact website or link.\",\n    );\n  }\n  const suggestions = data.suggestions ?? [];\n  const names = suggestions.map((s) => `${s.name} (${PLATFORM_NAMES[s.platform]})`).join(\", \");\n  if (data.status === \"unconfirmed\") {\n    const [first] = suggestions;\n    hints.push(\n      `Nothing followed yet: we found no account we're sure is this brand's, only accounts named like it: ${names}. Follow the brand's own with its link, e.g. baker winning-ads follow \"${first ? brandAccountInput(first) : \"\"}\", then add its other markets' accounts with \\`add-accounts\\`. Or retry with the brand's website.`,\n    );\n    return hints;\n  }\n  if (data.advertiser && suggestions.length > 0) {\n    const inputs = suggestions.map(brandAccountInput).join(\",\");\n    hints.push(\n      `Also found accounts named like this brand, not tracked yet: ${names}. If they are the same brand (another country or language), track them with: baker winning-ads add-accounts ${data.advertiser.advertiser_id} \"${inputs}\" — drop any that belong to someone else.`,\n    );\n  }\n  return hints.length > 0 ? hints : undefined;\n}\n\nexport const followCommand = defineCommand({\n  meta: {\n    name: \"follow\",\n    description:\n      'Follow a brand to track ALL its ads — every platform, every account and country. Paste a website (best), a brand name, or any profile/ad-library link. Example: baker winning-ads follow \"barkibu.com\"',\n  },\n  args: {\n    input: {\n      type: \"positional\",\n      description: \"Website (best), brand name, or any profile/ad-library link\",\n      required: true,\n    },\n    label: { type: \"string\", description: \"Optional display label\", required: false },\n    platform: {\n      type: \"string\",\n      description: \"Ignored — every platform is searched. Kept so older commands still run.\",\n      required: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const body: Record<string, unknown> = { input: String(args.input) };\n      if (args.label) {\n        body.label = String(args.label);\n      }\n\n      const data = await apiPost<FollowResponse>(\"/api/ad-library/follow\", body);\n      writeJson({ ok: true, data, hints: followHints(data) });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,0DAA0D,UAAU,MAAM;AAAA,EAClH;AACF,CAAC;AAQM,SAAS,YAAY,MAA4C;AACtE,QAAM,QAAkB,CAAC;AACzB,MAAI,KAAK,WAAW,SAAS;AAC3B,UAAM;AAAA,MACJ;AAAA,IACF;AAAA,EACF,WAAW,KAAK,WAAW,aAAa;AACtC,UAAM;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AACA,QAAM,cAAc,KAAK,eAAe,CAAC;AACzC,QAAM,QAAQ,YAAY,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,KAAK,eAAe,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,IAAI;AAC3F,MAAI,KAAK,WAAW,eAAe;AACjC,UAAM,CAAC,KAAK,IAAI;AAChB,UAAM;AAAA,MACJ,sGAAsG,KAAK,0EAA0E,QAAQ,kBAAkB,KAAK,IAAI,EAAE;AAAA,IAC5N;AACA,WAAO;AAAA,EACT;AACA,MAAI,KAAK,cAAc,YAAY,SAAS,GAAG;AAC7C,UAAM,SAAS,YAAY,IAAI,iBAAiB,EAAE,KAAK,GAAG;AAC1D,UAAM;AAAA,MACJ,+DAA+D,KAAK,+GAA+G,KAAK,WAAW,aAAa,KAAK,MAAM;AAAA,IAC7N;AAAA,EACF;AACA,SAAO,MAAM,SAAS,IAAI,QAAQ;AACpC;AAEO,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,0BAA0B,UAAU,MAAM;AAAA,IAChF,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAgC,EAAE,OAAO,OAAO,KAAK,KAAK,EAAE;AAClE,UAAI,KAAK,OAAO;AACd,aAAK,QAAQ,OAAO,KAAK,KAAK;AAAA,MAChC;AAEA,YAAM,OAAO,MAAM,QAAwB,0BAA0B,IAAI;AACzE,gBAAU,EAAE,IAAI,MAAM,MAAM,OAAO,YAAY,IAAI,EAAE,CAAC;AAAA,IACxD,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/follow-competitors-EURYGGXE.js

@@ -0,0 +1,112 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-ICJFL7DU.js";
+import {
+  apiPost
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  FOLLOW_BATCH_MAX,
+  registerSchema,
+  writeJson
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/follow-competitors.ts
+import { defineCommand } from "citty";
+var BATCH_TIMEOUT_MS = 3e5;
+function buildFollowBatchBody(input) {
+  const seen = /* @__PURE__ */ new Set();
+  const inputs = [];
+  for (const domain of splitList(input.domains)) {
+    const key = domain.toLowerCase();
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    inputs.push(domain);
+  }
+  return { inputs };
+}
+registerSchema({
+  command: "winning-ads.follow-competitors",
+  description: "Follow MANY brands at once \u2014 the fast way to add every competitor to your library. Pass a comma-separated list of domains (best \u2014 each resolves every platform and every account we can find, every country). One brand failing never blocks the others: the response reports per-brand status (following/added/ambiguous/failed) plus rollup counts. Ideal right after a competitor scan.",
+  args: {
+    domains: {
+      type: "string",
+      description: `Comma-separated domains (best), profile/ad-library URLs, or brand names \u2014 up to ${FOLLOW_BATCH_MAX}. e.g. "deel.com,notion.so,hubspot.com"`,
+      required: true
+    }
+  }
+});
+var followCompetitorsCommand = defineCommand({
+  meta: {
+    name: "follow-competitors",
+    description: 'Follow many brands at once by domain \u2014 add every competitor in one call. Example: baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"'
+  },
+  args: {
+    domains: {
+      type: "positional",
+      description: "Comma-separated domains (best), URLs, or brand names",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: "Ignored \u2014 every platform is searched. Kept so older commands still run.",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = buildFollowBatchBody({ domains: String(args.domains ?? "") });
+      if (body.inputs.length === 0) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "Pass at least one domain in --domains." }
+        });
+        process.exit(1);
+      }
+      if (body.inputs.length > FOLLOW_BATCH_MAX) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `Too many brands (${body.inputs.length}). Follow at most ${FOLLOW_BATCH_MAX} per call.`
+          }
+        });
+        process.exit(1);
+      }
+      const data = await apiPost("/api/ad-library/follow-batch", body, {
+        timeoutMs: BATCH_TIMEOUT_MS
+      });
+      const hints = [];
+      if (data.failed_count > 0) {
+        const failed = data.results.filter((r) => r.status === "failed").map((r) => r.input);
+        hints.push(
+          `${data.failed_count} brand(s) couldn't be added: ${failed.join(", ")}. Retry each with its website or Facebook/LinkedIn URL via \`baker winning-ads follow\`.`
+        );
+      }
+      if (data.ambiguous_count > 0) {
+        const ambiguous = data.results.filter((r) => r.status === "ambiguous").map((r) => r.input);
+        hints.push(
+          `${data.ambiguous_count} brand(s) matched multiple advertisers: ${ambiguous.join(", ")}. Re-run \`baker winning-ads follow\` with an exact domain/URL to pick one.`
+        );
+      }
+      if (data.added_count > 0) {
+        hints.push(
+          "Newly added brands are ingesting now \u2014 their winners fill in over the next few minutes. Check `baker winning-ads following` or `baker winning-ads feed`."
+        );
+      }
+      writeJson({ ok: true, data, hints: hints.length > 0 ? hints : void 0 });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  buildFollowBatchBody,
+  followCompetitorsCommand
+};
+//# sourceMappingURL=follow-competitors-EURYGGXE.js.map

package/dist/follow-competitors-EURYGGXE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/follow-competitors.ts"],"sourcesContent":["import { FOLLOW_BATCH_MAX, type FollowBatchResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError, splitList } from \"./shared.ts\";\n\n// A batch follows each brand sequentially — a paid resolve lookup + an ad-dna add\n// per brand, a few seconds each — so give it far more room than the default\n// request timeout. A timeout is safe anyway: each follow is idempotent, so an\n// already-followed brand returns instantly on a re-run.\nconst BATCH_TIMEOUT_MS = 300_000;\n\n/**\n * Build the `/api/ad-library/follow-batch` body from the CLI flags. Pure so the\n * csv-splitting + de-duplication is unit-testable without the transport. Dedupes\n * case-insensitively (following the same domain twice is a wasted lookup) while\n * preserving the first-seen order + original casing.\n */\nexport function buildFollowBatchBody(input: { domains?: string }): { inputs: string[] } {\n  const seen = new Set<string>();\n  const inputs: string[] = [];\n  for (const domain of splitList(input.domains)) {\n    const key = domain.toLowerCase();\n    if (seen.has(key)) {\n      continue;\n    }\n    seen.add(key);\n    inputs.push(domain);\n  }\n  return { inputs };\n}\n\nregisterSchema({\n  command: \"winning-ads.follow-competitors\",\n  description:\n    \"Follow MANY brands at once — the fast way to add every competitor to your library. Pass a comma-separated list of domains (best — each resolves every platform and every account we can find, every country). One brand failing never blocks the others: the response reports per-brand status (following/added/ambiguous/failed) plus rollup counts. Ideal right after a competitor scan.\",\n  args: {\n    domains: {\n      type: \"string\",\n      description: `Comma-separated domains (best), profile/ad-library URLs, or brand names — up to ${FOLLOW_BATCH_MAX}. e.g. \"deel.com,notion.so,hubspot.com\"`,\n      required: true,\n    },\n  },\n});\n\nexport const followCompetitorsCommand = defineCommand({\n  meta: {\n    name: \"follow-competitors\",\n    description:\n      'Follow many brands at once by domain — add every competitor in one call. Example: baker winning-ads follow-competitors \"deel.com,notion.so,hubspot.com\"',\n  },\n  args: {\n    domains: {\n      type: \"positional\",\n      description: \"Comma-separated domains (best), URLs, or brand names\",\n      required: true,\n    },\n    platform: {\n      type: \"string\",\n      description: \"Ignored — every platform is searched. Kept so older commands still run.\",\n      required: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const body = buildFollowBatchBody({ domains: String(args.domains ?? \"\") });\n      if (body.inputs.length === 0) {\n        writeJson({\n          ok: false,\n          error: { code: \"VALIDATION_ERROR\", message: \"Pass at least one domain in --domains.\" },\n        });\n        process.exit(1);\n      }\n      if (body.inputs.length > FOLLOW_BATCH_MAX) {\n        writeJson({\n          ok: false,\n          error: {\n            code: \"VALIDATION_ERROR\",\n            message: `Too many brands (${body.inputs.length}). Follow at most ${FOLLOW_BATCH_MAX} per call.`,\n          },\n        });\n        process.exit(1);\n      }\n\n      const data = await apiPost<FollowBatchResponse>(\"/api/ad-library/follow-batch\", body, {\n        timeoutMs: BATCH_TIMEOUT_MS,\n      });\n\n      const hints: string[] = [];\n      if (data.failed_count > 0) {\n        const failed = data.results.filter((r) => r.status === \"failed\").map((r) => r.input);\n        hints.push(\n          `${data.failed_count} brand(s) couldn't be added: ${failed.join(\", \")}. Retry each with its website or Facebook/LinkedIn URL via \\`baker winning-ads follow\\`.`,\n        );\n      }\n      if (data.ambiguous_count > 0) {\n        const ambiguous = data.results.filter((r) => r.status === \"ambiguous\").map((r) => r.input);\n        hints.push(\n          `${data.ambiguous_count} brand(s) matched multiple advertisers: ${ambiguous.join(\", \")}. Re-run \\`baker winning-ads follow\\` with an exact domain/URL to pick one.`,\n        );\n      }\n      if (data.added_count > 0) {\n        hints.push(\n          \"Newly added brands are ingesting now — their winners fill in over the next few minutes. Check `baker winning-ads following` or `baker winning-ads feed`.\",\n        );\n      }\n\n      writeJson({ ok: true, data, hints: hints.length > 0 ? hints : undefined });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAU9B,IAAM,mBAAmB;AAQlB,SAAS,qBAAqB,OAAmD;AACtF,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,SAAmB,CAAC;AAC1B,aAAW,UAAU,UAAU,MAAM,OAAO,GAAG;AAC7C,UAAM,MAAM,OAAO,YAAY;AAC/B,QAAI,KAAK,IAAI,GAAG,GAAG;AACjB;AAAA,IACF;AACA,SAAK,IAAI,GAAG;AACZ,WAAO,KAAK,MAAM;AAAA,EACpB;AACA,SAAO,EAAE,OAAO;AAClB;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aAAa,wFAAmF,gBAAgB;AAAA,MAChH,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAEM,IAAM,2BAA2B,cAAc;AAAA,EACpD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAO,qBAAqB,EAAE,SAAS,OAAO,KAAK,WAAW,EAAE,EAAE,CAAC;AACzE,UAAI,KAAK,OAAO,WAAW,GAAG;AAC5B,kBAAU;AAAA,UACR,IAAI;AAAA,UACJ,OAAO,EAAE,MAAM,oBAAoB,SAAS,yCAAyC;AAAA,QACvF,CAAC;AACD,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,UAAI,KAAK,OAAO,SAAS,kBAAkB;AACzC,kBAAU;AAAA,UACR,IAAI;AAAA,UACJ,OAAO;AAAA,YACL,MAAM;AAAA,YACN,SAAS,oBAAoB,KAAK,OAAO,MAAM,qBAAqB,gBAAgB;AAAA,UACtF;AAAA,QACF,CAAC;AACD,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,YAAM,OAAO,MAAM,QAA6B,gCAAgC,MAAM;AAAA,QACpF,WAAW;AAAA,MACb,CAAC;AAED,YAAM,QAAkB,CAAC;AACzB,UAAI,KAAK,eAAe,GAAG;AACzB,cAAM,SAAS,KAAK,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK;AACnF,cAAM;AAAA,UACJ,GAAG,KAAK,YAAY,gCAAgC,OAAO,KAAK,IAAI,CAAC;AAAA,QACvE;AAAA,MACF;AACA,UAAI,KAAK,kBAAkB,GAAG;AAC5B,cAAM,YAAY,KAAK,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK;AACzF,cAAM;AAAA,UACJ,GAAG,KAAK,eAAe,2CAA2C,UAAU,KAAK,IAAI,CAAC;AAAA,QACxF;AAAA,MACF;AACA,UAAI,KAAK,cAAc,GAAG;AACxB,cAAM;AAAA,UACJ;AAAA,QACF;AAAA,MACF;AAEA,gBAAU,EAAE,IAAI,MAAM,MAAM,OAAO,MAAM,SAAS,IAAI,QAAQ,OAAU,CAAC;AAAA,IAC3E,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/following-CA5BQXYB.js

@@ -0,0 +1,113 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-ICJFL7DU.js";
+import {
+  apiGet
+} from "./chunk-MMOTJIV6.js";
+import "./chunk-2ZZR2SOF.js";
+import "./chunk-YPCVPDU7.js";
+import {
+  applyFieldMask,
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-D3RTGIT4.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/following.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.following",
+  description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts. A brand still adding has counts that are a lie in progress; one with `discovery_failed` has counts that are short because we couldn't finish looking, which is not the same as it running no ads.",
+  args: {}
+});
+function displayStatus(status) {
+  return status === "ready" ? "ready" : "adding\u2026";
+}
+function compactFollowed(record) {
+  return {
+    followed_id: String(record.followed_id ?? ""),
+    advertiser_id: String(record.advertiser_id ?? ""),
+    label: String(record.label ?? ""),
+    status: displayStatus(record.status),
+    active_ad_count: record.active_ad_count ?? null,
+    total_ad_count: record.total_ad_count ?? null,
+    family_count: record.family_count ?? null,
+    adding_discovered: record.adding_discovered ?? null,
+    adding_enqueued: record.adding_enqueued ?? null,
+    adding_ingested: record.adding_ingested ?? null,
+    // Without this a brand we failed to finish looking at is indistinguishable
+    // from one that genuinely runs no ads — both read `ready` with 0 ads.
+    discovery_failed: record.discovery_failed ?? null
+  };
+}
+function followingHints(records) {
+  const hints = [];
+  const label = (r) => String(r.label ?? r.advertiser_id ?? "");
+  const incomplete = records.filter((r) => r.discovery_failed === true && r.status !== "adding\u2026");
+  if (incomplete.length > 0) {
+    hints.push(
+      `${incomplete.length} brand(s) couldn't be fully added: ${incomplete.map(label).join(", ")}. Their counts are incomplete \u2014 re-run \`baker winning-ads follow <domain>\` for each to try again.`
+    );
+  }
+  const adding = records.filter((r) => r.status === "adding\u2026");
+  if (adding.length > 0) {
+    hints.push(
+      `${adding.length} brand(s) are still being added: ${adding.map(label).join(", ")}. Their ad counts fill in over the next few minutes \u2014 don't report them as final, and don't re-follow to speed it up.`
+    );
+  }
+  return hints;
+}
+function followingNormalizer(record, full) {
+  const compact = compactFollowed(record);
+  if (!full) {
+    return compact;
+  }
+  return {
+    ...compact,
+    image_url: record.image_url ?? null,
+    platforms: Array.isArray(record.platforms) ? record.platforms : []
+  };
+}
+var followingCommand = defineCommand({
+  meta: {
+    name: "following",
+    description: "List brands you follow, with status (ready / adding\u2026) and cached counts. A brand's counts are only final once it is ready. Example: baker winning-ads following --output md"
+  },
+  args: {
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include image + platforms", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ad-library/following");
+      const output = args.output || "json";
+      const full = args.full;
+      const rawList = Array.isArray(data?.following) ? data.following : [];
+      const following = rawList.map((f) => followingNormalizer(f, full));
+      const hints = followingHints(following);
+      if (output === "json") {
+        const fields = splitList(args.fields);
+        const rows = fields.length > 0 ? following.map((f) => applyFieldMask(f, fields)) : following;
+        writeJson({ ok: true, data: { following: rows }, hints: hints.length > 0 ? hints : void 0 });
+        return;
+      }
+      writeOutput(
+        { ok: true, data: rawList, hints: hints.length > 0 ? hints : void 0 },
+        output,
+        args.fields ? args.fields.split(",") : void 0,
+        full,
+        followingNormalizer
+      );
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  followingCommand,
+  followingHints
+};
+//# sourceMappingURL=following-CA5BQXYB.js.map