@koda-sl/baker-cli 0.524.0-dev.3eb5500a1 → 0.525.0

package/dist/find-H24XAY3I.js

@@ -0,0 +1,143 @@
+import {
+  OUTPUT_ARGS,
+  compactFindResponse,
+  readOutputFlags,
+  writeProviderHits
+} from "./chunk-2AI7CZGS.js";
+import {
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  AUTO_INGEST_MAX,
+  parseAutoIngest
+} from "./chunk-KKJ4KJCW.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-DPPV45D5.js";
+import "./chunk-DERQLVKB.js";
+import "./chunk-ABXVFHTG.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-UCI6ZGUF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/find.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.find",
+  description: "Fanout image search: library first, then opted-in external providers.",
+  args: {
+    query: { type: "string", description: "Search query", required: true },
+    sources: {
+      type: "string",
+      description: "Comma-separated providers: library,pexels,pixabay,google,iconify,giphy,pinterest (brandfetch lives at `baker images logo`)",
+      required: false
+    },
+    limit: { type: "number", description: "Max results per group", required: false, default: 20 },
+    fallback: {
+      type: "boolean",
+      description: "Only cascade to externals when top library score < threshold",
+      required: false,
+      default: false
+    },
+    threshold: { type: "number", description: "Fallback threshold (0-1)", required: false, default: 0.6 },
+    "auto-ingest": {
+      type: "number",
+      description: `Auto-ingest top N external hits (0-${AUTO_INGEST_MAX.find}, default 0) and return Baker-owned URLs on ingested hits`,
+      required: false,
+      default: 0
+    },
+    context: {
+      type: "string",
+      description: "Free-text hint applied to every auto-ingested hit (overrides provider-derived context)",
+      required: false
+    },
+    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: "The response unchanged instead of compact hits",
+      required: false,
+      default: false
+    }
+  }
+});
+var findCommand = defineCommand({
+  meta: {
+    name: "find",
+    description: "Library-first fanout image search. Opt in to providers with --sources. `--fallback` short-circuits to externals only when library is thin. With --auto-ingest, ingested external hits return Baker-owned URLs. Prints { groups: { library, external }, ingested, meta } with compact hits (source, url, imageId, imageUrl, name, width, height, a one-line description, score); --full prints the response unchanged.\n\nExample: baker images find 'office' --sources library,pexels --limit 20"
+  },
+  args: {
+    query: { type: "positional", description: "Search query", required: false },
+    sources: { type: "string", description: "Comma-separated providers", required: false },
+    limit: { type: "string", description: "Max results per group (default 20)", required: false },
+    fallback: { type: "boolean", description: "Cascade to externals only when library thin", required: false },
+    threshold: { type: "string", description: "Fallback threshold (default 0.6)", required: false },
+    "auto-ingest": {
+      type: "string",
+      description: `Auto-ingest top N external hits (0-${AUTO_INGEST_MAX.find}) and return Baker-owned URLs on ingested hits`,
+      required: false
+    },
+    context: { type: "string", description: "Description context hint applied to auto-ingested hits", required: false },
+    ...OUTPUT_ARGS
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.sources) {
+        body.sources = args.sources.split(",").filter(Boolean);
+      }
+      if (args.limit) body.limit = Number(args.limit);
+      if (args.fallback) body.fallback = true;
+      if (args.threshold) body.threshold = Number(args.threshold);
+      if (args["auto-ingest"] !== void 0) {
+        const parsed = parseAutoIngest(args["auto-ingest"], AUTO_INGEST_MAX.find);
+        if (!parsed.ok) {
+          writeJson({
+            ok: false,
+            error: {
+              code: "VALIDATION_ERROR",
+              message: parsed.message,
+              fix: {
+                action: "retry_with_changes",
+                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.find}.`
+              }
+            }
+          });
+          process.exit(1);
+        }
+        body.autoIngest = parsed.value;
+      }
+      if (args.context) body.descriptionContext = args.context;
+      const data = await apiPost("/api/images/find", body);
+      const hits = [...data.groups.library, ...data.groups.external];
+      const hints = emptyResultHints({
+        provider: "find",
+        hitCount: hits.length,
+        activeFilters: args.fallback ? ["--fallback"] : [],
+        subject: query
+      });
+      const { format, full } = readOutputFlags(args);
+      const printed = format === "json" && !full ? compactFindResponse(data) : data;
+      writeProviderHits(printed, hits, args, hints);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  findCommand
+};
+//# sourceMappingURL=find-H24XAY3I.js.map

package/dist/find-H24XAY3I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/find.ts"],"sourcesContent":["import type { ImagesFindRequest, ImagesFindResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { AUTO_INGEST_MAX, parseAutoIngest } from \"./autoIngest.ts\";\nimport { compactFindResponse, OUTPUT_ARGS, readOutputFlags, writeProviderHits } from \"./providerHits.ts\";\nimport { emptyResultHints } from \"./searchHints.ts\";\n\nregisterSchema({\n  command: \"images.find\",\n  description: \"Fanout image search: library first, then opted-in external providers.\",\n  args: {\n    query: { type: \"string\", description: \"Search query\", required: true },\n    sources: {\n      type: \"string\",\n      description:\n        \"Comma-separated providers: library,pexels,pixabay,google,iconify,giphy,pinterest (brandfetch lives at `baker images logo`)\",\n      required: false,\n    },\n    limit: { type: \"number\", description: \"Max results per group\", required: false, default: 20 },\n    fallback: {\n      type: \"boolean\",\n      description: \"Only cascade to externals when top library score < threshold\",\n      required: false,\n      default: false,\n    },\n    threshold: { type: \"number\", description: \"Fallback threshold (0-1)\", required: false, default: 0.6 },\n    \"auto-ingest\": {\n      type: \"number\",\n      description: `Auto-ingest top N external hits (0-${AUTO_INGEST_MAX.find}, default 0) and return Baker-owned URLs on ingested hits`,\n      required: false,\n      default: 0,\n    },\n    context: {\n      type: \"string\",\n      description: \"Free-text hint applied to every auto-ingested hit (overrides provider-derived context)\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: {\n      type: \"boolean\",\n      description: \"The response unchanged instead of compact hits\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nexport const findCommand = defineCommand({\n  meta: {\n    name: \"find\",\n    description:\n      \"Library-first fanout image search. Opt in to providers with --sources. `--fallback` short-circuits to externals only when library is thin. With --auto-ingest, ingested external hits return Baker-owned URLs. Prints { groups: { library, external }, ingested, meta } with compact hits (source, url, imageId, imageUrl, name, width, height, a one-line description, score); --full prints the response unchanged.\\n\\nExample: baker images find 'office' --sources library,pexels --limit 20\",\n  },\n  args: {\n    query: { type: \"positional\", description: \"Search query\", required: false },\n    sources: { type: \"string\", description: \"Comma-separated providers\", required: false },\n    limit: { type: \"string\", description: \"Max results per group (default 20)\", required: false },\n    fallback: { type: \"boolean\", description: \"Cascade to externals only when library thin\", required: false },\n    threshold: { type: \"string\", description: \"Fallback threshold (default 0.6)\", required: false },\n    \"auto-ingest\": {\n      type: \"string\",\n      description: `Auto-ingest top N external hits (0-${AUTO_INGEST_MAX.find}) and return Baker-owned URLs on ingested hits`,\n      required: false,\n    },\n    context: { type: \"string\", description: \"Description context hint applied to auto-ingested hits\", required: false },\n    ...OUTPUT_ARGS,\n  },\n  run: async ({ args }) => {\n    try {\n      const query = args.query as string | undefined;\n      if (!query) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Query is required\" } });\n        process.exit(1);\n      }\n      const body: ImagesFindRequest = { query };\n      if (args.sources) {\n        body.sources = (args.sources as string).split(\",\").filter(Boolean) as ImagesFindRequest[\"sources\"];\n      }\n      if (args.limit) body.limit = Number(args.limit);\n      if (args.fallback) body.fallback = true;\n      if (args.threshold) body.threshold = Number(args.threshold);\n      if (args[\"auto-ingest\"] !== undefined) {\n        const parsed = parseAutoIngest(args[\"auto-ingest\"], AUTO_INGEST_MAX.find);\n        if (!parsed.ok) {\n          writeJson({\n            ok: false,\n            error: {\n              code: \"VALIDATION_ERROR\",\n              message: parsed.message,\n              fix: {\n                action: \"retry_with_changes\",\n                explanation: `Re-run with --auto-ingest in 0-${AUTO_INGEST_MAX.find}.`,\n              },\n            },\n          });\n          process.exit(1);\n        }\n        body.autoIngest = parsed.value;\n      }\n      if (args.context) body.descriptionContext = args.context as string;\n\n      const data = await apiPost<ImagesFindResponse>(\"/api/images/find\", body);\n      // `find` groups its results; the flag trio tabulates them as one list,\n      // since \"which of these can I use\" reads across both groups.\n      const hits = [...data.groups.library, ...data.groups.external];\n      const hints = emptyResultHints({\n        provider: \"find\",\n        hitCount: hits.length,\n        activeFilters: args.fallback ? [\"--fallback\"] : [],\n        subject: query,\n      });\n      // JSON prints the compact hits by default; `--full` is the response as sent.\n      const { format, full } = readOutputFlags(args as Record<string, unknown>);\n      const printed = format === \"json\" && !full ? compactFindResponse(data) : data;\n      writeProviderHits(printed, hits, args as Record<string, unknown>, hints);\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/fit-GEDS2RRK.js

@@ -0,0 +1,65 @@
+import {
+  FitAnswerSchema,
+  NO_FIT_HINT,
+  buildFitPrompt,
+  conceptFromFit,
+  fitCachePath,
+  fitCommand,
+  fitHints,
+  fitKeyOf,
+  fitOnce,
+  fitReference,
+  pictureOf,
+  readCachedFit,
+  readKnowledge,
+  rejectForAudience,
+  reviewsForFit
+} from "./chunk-DM6LTYOQ.js";
+import "./chunk-ED3OAFEO.js";
+import "./chunk-XZLGG2AT.js";
+import "./chunk-N727QO5G.js";
+import "./chunk-IGG52H7X.js";
+import "./chunk-KL4H62CA.js";
+import "./chunk-TMVNSRSX.js";
+import "./chunk-ER3V3FVG.js";
+import "./chunk-5QRF7ANY.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-HQWSGOAC.js";
+import "./chunk-AEUKCVG6.js";
+import "./chunk-SGEHQTEJ.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-DGWSMAKI.js";
+import "./chunk-TCYK35RZ.js";
+import "./chunk-G2NUIZ74.js";
+import "./chunk-OMORXBRN.js";
+import "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import "./chunk-DPPV45D5.js";
+import "./chunk-DERQLVKB.js";
+import "./chunk-ABXVFHTG.js";
+import "./chunk-UCI6ZGUF.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  FitAnswerSchema,
+  NO_FIT_HINT,
+  buildFitPrompt,
+  conceptFromFit,
+  fitCachePath,
+  fitCommand,
+  fitHints,
+  fitKeyOf,
+  fitOnce,
+  fitReference,
+  pictureOf,
+  readCachedFit,
+  readKnowledge,
+  rejectForAudience,
+  reviewsForFit
+};
+//# sourceMappingURL=fit-GEDS2RRK.js.map

package/dist/flows-2INFTGLY.js

@@ -0,0 +1,250 @@
+import {
+  collectConfigStatus,
+  collectSideEffects,
+  listFlowSlugs,
+  readFlowTree,
+  readSettings,
+  redactTree,
+  requestFlowInputCall,
+  withSettings
+} from "./chunk-MPRC7FAK.js";
+import {
+  FLOW_AGENT_DESTINATION_KINDS,
+  driftRepairHint,
+  flowNodeTriggers
+} from "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-DPPV45D5.js";
+import "./chunk-DERQLVKB.js";
+import "./chunk-ABXVFHTG.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-UCI6ZGUF.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-D4WTTOJD.js").then((m) => m.schemaCommand),
+    "add-node": () => import("./add-RAL7GDKT.js").then((m) => m.addNodeCommand),
+    "add-side-effect": () => import("./add-RAL7GDKT.js").then((m) => m.addSideEffectCommand),
+    options: () => import("./options-OQPIK3JZ.js").then((m) => m.optionsCommand),
+    connect: () => import("./connect-UXLCEZPO.js").then((m) => m.connectCommand),
+    map: () => import("./map-PWD5HNDL.js").then((m) => m.mapCommand),
+    normalize: () => import("./normalize-K4ESALR4.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-2INFTGLY.js.map

package/dist/follow-RZIVLFTP.js

@@ -0,0 +1,94 @@
+import {
+  PLATFORM_NAMES,
+  reportError
+} from "./chunk-6JACV223.js";
+import {
+  apiPost
+} from "./chunk-DPPV45D5.js";
+import "./chunk-DERQLVKB.js";
+import "./chunk-ABXVFHTG.js";
+import {
+  brandAccountInput,
+  registerSchema,
+  writeJson
+} from "./chunk-UCI6ZGUF.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-RZIVLFTP.js.map