@koda-sl/baker-cli 0.384.0-dev.4699b7308 → 0.384.0-dev.557795bef

package/dist/chunk-Q6ULQMWG.js

@@ -0,0 +1,41 @@
+// src/commands/images/searchHints.ts
+var SUBJECT_PLACEHOLDER = {
+  stock: "<query>",
+  google: "<query>",
+  library: "<query>",
+  find: "<query>",
+  logo: "<domain>",
+  icon: "<name>"
+};
+var FALLBACK = {
+  stock: () => "Still empty \u2192 `baker images find <query> --sources library,pinterest,google` (one call across the providers stock does not cover \u2014 `--sources` is required, `find` alone searches the library only) or `baker studio generate` to make the asset. Do not re-run this search with reshuffled flags.",
+  google: () => "Still empty \u2192 `baker studio generate` to make the asset. Google is the last-resort provider; there is nothing below it to retry.",
+  // The library is step 1 of the sourcing recipe, so its empty result is the
+  // most common one an agent hits — and the one that previously steered nowhere.
+  library: () => "The library does not hold this yet \u2014 that is a normal starting state, not a failure. Source it externally, which also files it into the library for next time: `baker images find <query> --sources library,pexels,pixabay,pinterest,google` for a broad sweep, `baker images stock <query>` for photography or `--type vector` for artwork, `baker images logo <domain>` for a brand mark, or `baker studio generate` to make it. Do not re-run this search with reshuffled filters.",
+  find: () => "`find` searches only the sources you name \u2014 with no `--sources` it searches the library alone, which is the usual cause of an empty fanout. Re-run as `baker images find <query> --sources library,pexels,pixabay,pinterest,google`. If that is still empty, `baker studio generate` makes the asset.",
+  logo: (subject) => `Brandfetch does not know this domain \u2014 that is normal for small or recently renamed brands, and is not a failure. Pull the mark off the brand's own site instead: \`baker images extract https://${subject}\`. For a tech or product mark also try \`baker images icon <name> --set logos\`.`,
+  icon: (subject) => `No icon matched. Iconify is set-scoped, so the set is usually the problem, not the name: retry with \`baker images icon ${subject} --set lucide\` (UI glyphs), \`--set simple-icons\` or \`--set logos\` (brand marks), \`--set devicon\` (tech stack). Still nothing \u2192 \`baker images stock ${subject} --type vector\`, then \`baker studio generate\` with the vector model.`
+};
+function emptyResultHints({ provider, hitCount, activeFilters, subject }) {
+  if (hitCount > 0) {
+    return [];
+  }
+  const hints = [];
+  if (activeFilters.length > 0) {
+    hints.push(
+      `No hits. Drop the filters before touching the query \u2014 ${activeFilters.join(", ")} narrowed this search and filter combinations are the usual cause of an empty result.`
+    );
+  }
+  hints.push(FALLBACK[provider](subject && subject.length > 0 ? subject : SUBJECT_PLACEHOLDER[provider]));
+  return hints;
+}
+function activeFilterFlags(args, candidates) {
+  return candidates.filter((flag) => args[flag] !== void 0 && args[flag] !== "").map((flag) => `--${flag}`);
+}
+
+export {
+  emptyResultHints,
+  activeFilterFlags
+};
+//# sourceMappingURL=chunk-Q6ULQMWG.js.map

package/dist/chunk-Q6ULQMWG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/searchHints.ts"],"sourcesContent":["/**\n * Zero-hit steering for the single-provider image searches.\n *\n * A provider search that returns nothing gives the agent no signal about WHY,\n * so it re-runs the same query with reshuffled flags until it gives up — the\n * dominant time sink in image sourcing. These hints name the two real exits:\n * drop the filters that narrowed the search, then leave the provider entirely.\n */\n\nexport type ImageSearchProvider = \"stock\" | \"google\" | \"library\" | \"find\" | \"logo\" | \"icon\";\n\ninterface EmptyResultInput {\n  provider: ImageSearchProvider;\n  hitCount: number;\n  activeFilters: string[];\n  /** What was searched for — a domain for `logo`, an icon name for `icon`.\n   * Interpolated into the exit route so the agent gets a runnable command\n   * rather than a shape to fill in. */\n  subject?: string;\n}\n\n/** Stand-in when the caller passes no subject, so the hint still reads as a command. */\nconst SUBJECT_PLACEHOLDER: Record<ImageSearchProvider, string> = {\n  stock: \"<query>\",\n  google: \"<query>\",\n  library: \"<query>\",\n  find: \"<query>\",\n  logo: \"<domain>\",\n  icon: \"<name>\",\n};\n\nconst FALLBACK: Record<ImageSearchProvider, (subject: string) => string> = {\n  stock: () =>\n    \"Still empty → `baker images find <query> --sources library,pinterest,google` (one call across the providers stock does not cover — `--sources` is required, `find` alone searches the library only) or `baker studio generate` to make the asset. Do not re-run this search with reshuffled flags.\",\n  google: () =>\n    \"Still empty → `baker studio generate` to make the asset. Google is the last-resort provider; there is nothing below it to retry.\",\n  // The library is step 1 of the sourcing recipe, so its empty result is the\n  // most common one an agent hits — and the one that previously steered nowhere.\n  library: () =>\n    \"The library does not hold this yet — that is a normal starting state, not a failure. Source it externally, which also files it into the library for next time: `baker images find <query> --sources library,pexels,pixabay,pinterest,google` for a broad sweep, `baker images stock <query>` for photography or `--type vector` for artwork, `baker images logo <domain>` for a brand mark, or `baker studio generate` to make it. Do not re-run this search with reshuffled filters.\",\n  find: () =>\n    \"`find` searches only the sources you name — with no `--sources` it searches the library alone, which is the usual cause of an empty fanout. Re-run as `baker images find <query> --sources library,pexels,pixabay,pinterest,google`. If that is still empty, `baker studio generate` makes the asset.\",\n  logo: (subject) =>\n    `Brandfetch does not know this domain — that is normal for small or recently renamed brands, and is not a failure. Pull the mark off the brand's own site instead: \\`baker images extract https://${subject}\\`. For a tech or product mark also try \\`baker images icon <name> --set logos\\`.`,\n  icon: (subject) =>\n    `No icon matched. Iconify is set-scoped, so the set is usually the problem, not the name: retry with \\`baker images icon ${subject} --set lucide\\` (UI glyphs), \\`--set simple-icons\\` or \\`--set logos\\` (brand marks), \\`--set devicon\\` (tech stack). Still nothing → \\`baker images stock ${subject} --type vector\\`, then \\`baker studio generate\\` with the vector model.`,\n};\n\nexport function emptyResultHints({ provider, hitCount, activeFilters, subject }: EmptyResultInput): string[] {\n  if (hitCount > 0) {\n    return [];\n  }\n  const hints: string[] = [];\n  if (activeFilters.length > 0) {\n    hints.push(\n      `No hits. Drop the filters before touching the query — ${activeFilters.join(\", \")} narrowed this search and filter combinations are the usual cause of an empty result.`,\n    );\n  }\n  hints.push(FALLBACK[provider](subject && subject.length > 0 ? subject : SUBJECT_PLACEHOLDER[provider]));\n  return hints;\n}\n\n/** The flags the caller actually passed, in the agent's own vocabulary. */\nexport function activeFilterFlags(args: Record<string, unknown>, candidates: string[]): string[] {\n  return candidates.filter((flag) => args[flag] !== undefined && args[flag] !== \"\").map((flag) => `--${flag}`);\n}\n"],"mappings":";AAsBA,IAAM,sBAA2D;AAAA,EAC/D,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AACR;AAEA,IAAM,WAAqE;AAAA,EACzE,OAAO,MACL;AAAA,EACF,QAAQ,MACN;AAAA;AAAA;AAAA,EAGF,SAAS,MACP;AAAA,EACF,MAAM,MACJ;AAAA,EACF,MAAM,CAAC,YACL,yMAAoM,OAAO;AAAA,EAC7M,MAAM,CAAC,YACL,2HAA2H,OAAO,mKAA8J,OAAO;AAC3S;AAEO,SAAS,iBAAiB,EAAE,UAAU,UAAU,eAAe,QAAQ,GAA+B;AAC3G,MAAI,WAAW,GAAG;AAChB,WAAO,CAAC;AAAA,EACV;AACA,QAAM,QAAkB,CAAC;AACzB,MAAI,cAAc,SAAS,GAAG;AAC5B,UAAM;AAAA,MACJ,8DAAyD,cAAc,KAAK,IAAI,CAAC;AAAA,IACnF;AAAA,EACF;AACA,QAAM,KAAK,SAAS,QAAQ,EAAE,WAAW,QAAQ,SAAS,IAAI,UAAU,oBAAoB,QAAQ,CAAC,CAAC;AACtG,SAAO;AACT;AAGO,SAAS,kBAAkB,MAA+B,YAAgC;AAC/F,SAAO,WAAW,OAAO,CAAC,SAAS,KAAK,IAAI,MAAM,UAAa,KAAK,IAAI,MAAM,EAAE,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE;AAC7G;","names":[]}

package/dist/chunk-QKFD6PPX.js

@@ -0,0 +1,57 @@
+import {
+  formEventKey
+} from "./chunk-QMLGJ5OW.js";
+import {
+  flowNodeTriggers
+} from "./chunk-O6XZIQXZ.js";
+
+// ../api/src/analytics/flowEventKeys.ts
+function flowNodes(node, acc = []) {
+  if (!node || typeof node !== "object") return acc;
+  const record = node;
+  acc.push(record);
+  if (Array.isArray(record.children)) for (const child of record.children) flowNodes(child, acc);
+  return acc;
+}
+function flowEventKeys(tree, slug) {
+  const primary = [];
+  const secondary = [];
+  const nodes = flowNodes(tree).filter((node) => typeof node.id === "string" && node.id !== "");
+  if (nodes.length === 0) return [];
+  for (const node of nodes) {
+    const id = node.id;
+    const triggers = flowNodeTriggers(node.nodeData);
+    for (const triggerId of triggers.available) {
+      const candidate = {
+        eventKey: formEventKey(slug, id, triggerId),
+        nodeId: id,
+        nodeName: typeof node.name === "string" ? node.name : id,
+        nodeType: triggers.type,
+        triggerId,
+        isCompletion: triggers.completion === triggerId
+      };
+      (candidate.isCompletion ? primary : secondary).push(candidate);
+    }
+  }
+  return [
+    ...primary,
+    ...secondary,
+    {
+      eventKey: `submit:${slug}`,
+      nodeId: null,
+      nodeName: "the Form ran out of steps",
+      nodeType: null,
+      triggerId: null,
+      // A Form reaching its last node is as primary as an outcome gets for a
+      // Form with no widget in it — but it never fires on one that ends in a
+      // booking widget or a redirect, so it does not lead the list.
+      isCompletion: false
+    }
+  ];
+}
+
+export {
+  flowNodes,
+  flowEventKeys
+};
+//# sourceMappingURL=chunk-QKFD6PPX.js.map

package/dist/chunk-QKFD6PPX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/analytics/flowEventKeys.ts"],"sourcesContent":["/**\n * Every event a Form's own steps raise, built from the Form's tree.\n *\n * A Form published by Baker emits its events natively: every step raises the\n * triggers its node type has, and the Form raises `submit:<slug>` when it runs\n * out of steps. Nothing has to be registered for that to happen — no Source, no\n * conversion, no setting. But the lists a person or an agent PICKS an event\n * from are built from the event store, which knows an event only after somebody\n * has fired it. So a Form published five minutes ago offered nothing to pick,\n * and the only affordances left on the picker were \"type the name by hand\" and\n * \"add a Source\" — a door for a company's own systems, offered for an event a\n * Baker page already sends. Both of those are how a funnel step ends up wired\n * to a key that counts zero forever.\n *\n * This is the other half: the keys derived from the tree, offered at zero,\n * exactly as a Source is offered before its first send. Same builder\n * (`formEventKey`), same trigger table (`flowNodeTriggers`), so a key from here\n * and a key from the SQL are the same string.\n */\n\nimport { flowNodeTriggers } from \"../flowCatalog\";\nimport { formEventKey } from \"./eventKey\";\n\ntype AnyRecord = Record<string, unknown>;\n\nexport interface FlowEventKey {\n  eventKey: string;\n  /** `null` for the Form-level `submit:` key, which belongs to no step. */\n  nodeId: string | null;\n  nodeName: string;\n  nodeType: string | null;\n  triggerId: string | null;\n  /** Whether this is the moment that step exists to produce. */\n  isCompletion: boolean;\n}\n\n/** Every node of a Form tree, parents before children. */\nexport function flowNodes(node: unknown, acc: AnyRecord[] = []): AnyRecord[] {\n  if (!node || typeof node !== \"object\") return acc;\n  const record = node as AnyRecord;\n  acc.push(record);\n  if (Array.isArray(record.children)) for (const child of record.children) flowNodes(child, acc);\n  return acc;\n}\n\n/**\n * Every event key this Form can produce, each step's completion first.\n *\n * Completion triggers lead because they are what a person means by \"reached\n * this step\"; the lifecycle triggers a widget also raises (\"the embedded form\n * finished loading\") follow rather than being hidden, since an embedded\n * checkout genuinely reports through one of them. The order says nothing about\n * which ending is the Form's outcome — that is the agent's call.\n */\nexport function flowEventKeys(tree: unknown, slug: string): FlowEventKey[] {\n  const primary: FlowEventKey[] = [];\n  const secondary: FlowEventKey[] = [];\n\n  // A tree with no identified step raises nothing, and `submit:<slug>` for it\n  // would be the very thing this file exists to prevent: a real-looking key\n  // that counts zero for ever. It happens — a `_data.json` holding `null` or\n  // `{}`, a folder a flow-builder loop created and has not finished writing.\n  const nodes = flowNodes(tree).filter((node) => typeof node.id === \"string\" && node.id !== \"\");\n  if (nodes.length === 0) return [];\n\n  for (const node of nodes) {\n    const id = node.id as string;\n    const triggers = flowNodeTriggers(node.nodeData);\n    for (const triggerId of triggers.available) {\n      const candidate: FlowEventKey = {\n        eventKey: formEventKey(slug, id, triggerId),\n        nodeId: id,\n        nodeName: typeof node.name === \"string\" ? node.name : id,\n        nodeType: triggers.type,\n        triggerId,\n        isCompletion: triggers.completion === triggerId,\n      };\n      (candidate.isCompletion ? primary : secondary).push(candidate);\n    }\n  }\n\n  return [\n    ...primary,\n    ...secondary,\n    {\n      eventKey: `submit:${slug}`,\n      nodeId: null,\n      nodeName: \"the Form ran out of steps\",\n      nodeType: null,\n      triggerId: null,\n      // A Form reaching its last node is as primary as an outcome gets for a\n      // Form with no widget in it — but it never fires on one that ends in a\n      // booking widget or a redirect, so it does not lead the list.\n      isCompletion: false,\n    },\n  ];\n}\n"],"mappings":";;;;;;;;AAqCO,SAAS,UAAU,MAAe,MAAmB,CAAC,GAAgB;AAC3E,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,SAAS;AACf,MAAI,KAAK,MAAM;AACf,MAAI,MAAM,QAAQ,OAAO,QAAQ,EAAG,YAAW,SAAS,OAAO,SAAU,WAAU,OAAO,GAAG;AAC7F,SAAO;AACT;AAWO,SAAS,cAAc,MAAe,MAA8B;AACzE,QAAM,UAA0B,CAAC;AACjC,QAAM,YAA4B,CAAC;AAMnC,QAAM,QAAQ,UAAU,IAAI,EAAE,OAAO,CAAC,SAAS,OAAO,KAAK,OAAO,YAAY,KAAK,OAAO,EAAE;AAC5F,MAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAEhC,aAAW,QAAQ,OAAO;AACxB,UAAM,KAAK,KAAK;AAChB,UAAM,WAAW,iBAAiB,KAAK,QAAQ;AAC/C,eAAW,aAAa,SAAS,WAAW;AAC1C,YAAM,YAA0B;AAAA,QAC9B,UAAU,aAAa,MAAM,IAAI,SAAS;AAAA,QAC1C,QAAQ;AAAA,QACR,UAAU,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO;AAAA,QACtD,UAAU,SAAS;AAAA,QACnB;AAAA,QACA,cAAc,SAAS,eAAe;AAAA,MACxC;AACA,OAAC,UAAU,eAAe,UAAU,WAAW,KAAK,SAAS;AAAA,IAC/D;AAAA,EACF;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,IACH;AAAA,MACE,UAAU,UAAU,IAAI;AAAA,MACxB,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,UAAU;AAAA,MACV,WAAW;AAAA;AAAA;AAAA;AAAA,MAIX,cAAc;AAAA,IAChB;AAAA,EACF;AACF;","names":[]}