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

package/dist/chunk-Z7MWSXLG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/landing/inspiration/shared.ts"],"sourcesContent":["import type { InspirationFavoritesHealth } from \"@baker/api/landing-library\";\nimport { ApiError } from \"../../../client.ts\";\nimport { writeJson } from \"../../../output.ts\";\n\n/**\n * The framing every consumer of the library gets.\n *\n * These are not decoration. The corpus only earns its keep if what comes out of\n * it gets re-expressed rather than pasted, and a hint that fires on every single\n * call is the cheapest place to say so — cheaper than a doc the agent may not\n * re-read, and softer than the critic that will block a clone at publish.\n */\nexport const INSPIRATION_HINTS = {\n  adapt:\n    \"Reference only. Re-express this in the client's BRAND.md palette, type and imagery register. \" +\n    \"Reusing a headline, subhead or CTA verbatim is a Tier 0 message-match failure (references/gotchas.md).\",\n  structureNotCopy:\n    \"Take the structural decision, not the furniture: what the eye hits first, the grid ratio, \" +\n    \"what was deliberately left out. Your copy must come from the client's own offer.\",\n} as const;\n\n/**\n * Say what is actually true about a thin favorites result.\n *\n * `search` defaults to this company's saved sections, and that default is a\n * deliberate choice — those are the client's own taste signals, and quietly\n * widening it would replace their taste with the library's average. But a thin\n * favorites result has three completely different causes that look identical\n * from the outside:\n *\n *  1. the client has no taste profile yet,\n *  2. the client saved plenty and the pages failed to be read,\n *  3. the query simply did not match.\n *\n * They call for opposite next moves, and one production company sat in case 2\n * with **211 of 234 saved pages holding no sections at all** — where the honest\n * answer, \"your library is broken\", was being delivered as \"nothing saved yet\".\n *\n * So: never widen the scope, always name the cause, and always leave the\n * decision with the caller.\n */\nexport function favoritesScopeHints(health: InspirationFavoritesHealth | undefined, resultCount: number): string[] {\n  if (!health) return [];\n\n  const hints: string[] = [];\n\n  if (health.savedPages === 0) {\n    hints.push(\n      \"This company hasn't saved any reference pages yet, so there is no taste profile to search — an empty result here says nothing about the library. \" +\n        \"Search the whole shared library with --scope all, or save a page the client admires with `baker landing inspiration add <url>`.\",\n    );\n    return hints;\n  }\n\n  if (health.failedPages > 0) {\n    const retryable = health.failedExamples.filter((example) => example.retryable).map((example) => example.url);\n    const permanent = health.failedExamples.filter((example) => !example.retryable).map((example) => example.url);\n    hints.push(\n      `${health.failedPages} of this company's ${health.savedPages} saved pages could not be read, so they hold no sections — ` +\n        `only ${health.usablePages} are usable, which is why this result is thin. Search the whole library with --scope all.`,\n    );\n    if (retryable.length > 0) {\n      hints.push(\n        `Worth another go: ${retryable.join(\", \")} — run \\`baker landing inspiration add <url>\\` on one of them to study it again.`,\n      );\n    }\n    if (permanent.length > 0) {\n      hints.push(`Not worth retrying — these sites refuse automated readers: ${permanent.join(\", \")}.`);\n    }\n  }\n\n  if (health.studyingPages > 0) {\n    hints.push(\n      `${health.studyingPages} saved ${health.studyingPages === 1 ? \"page is\" : \"pages are\"} still being studied and will be searchable in a few minutes. Carry on; do not wait on them.`,\n    );\n  }\n\n  if (resultCount === 0 && health.failedPages === 0 && health.studyingPages === 0) {\n    hints.push(\n      `Nothing in this company's ${health.usablePages} readable saved pages matches. The saved set is healthy, so this is the query, not the library — loosen the filters or search everything with --scope all.`,\n    );\n  }\n\n  return hints;\n}\n\n/** Warn when the extracted markup is known not to match what the screenshot shows. */\nexport function fidelityHint(fidelity: number | null | undefined): string | null {\n  if (fidelity == null) return null;\n  if (fidelity >= 0.9) return null;\n  if (fidelity >= 0.75) {\n    return `Reproduction fidelity ${fidelity.toFixed(2)} — the markup is close but not exact. Trust the screenshot over the code.`;\n  }\n  return (\n    `Reproduction fidelity ${fidelity.toFixed(2)} — this section is scroll- or JS-driven and the extracted markup ` +\n    `does NOT render like the original. Use the screenshot and the notes; treat the code as a hint only.`\n  );\n}\n\nconst STALE_COPY_AFTER_MS = 30 * 24 * 60 * 60 * 1000;\n\n/**\n * Tell the agent a page's copy is old, before it builds from it.\n *\n * The library refreshes itself about monthly, but a site can redesign the day\n * after its read, and an agent copying last quarter's hero is building from\n * something the client can see is wrong.\n */\n/** `filedUrl`, never the address the capture landed on: after a redirect, refreshing that one files a second copy. */\nexport function staleCopyHint(studiedAt: number | null | undefined, filedUrl: string, now = Date.now()): string | null {\n  if (!studiedAt || now - studiedAt < STALE_COPY_AFTER_MS) return null;\n  const date = new Date(studiedAt).toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\", timeZone: \"UTC\" });\n  return `This copy of the page was read on ${date}. If the user says the live page looks different, run: baker landing inspiration add ${filedUrl} --refresh`;\n}\n\nexport function reportError(error: unknown): never {\n  if (error instanceof ApiError) {\n    writeJson({ ok: false, error: { code: error.code, message: error.message } });\n  } else {\n    writeJson({\n      ok: false,\n      error: { code: \"UNKNOWN\", message: error instanceof Error ? error.message : String(error) },\n    });\n  }\n  process.exit(1);\n}\n\nexport function splitList(value: string | undefined): string[] | undefined {\n  if (!value) return undefined;\n  const parts = value\n    .split(\",\")\n    .map((part) => part.trim())\n    .filter(Boolean);\n  return parts.length > 0 ? parts : undefined;\n}\n\nexport function parseNumber(value: string | undefined): number | undefined {\n  if (value === undefined || value === \"\") return undefined;\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n"],"mappings":";;;;;;;;AAYO,IAAM,oBAAoB;AAAA,EAC/B,OACE;AAAA,EAEF,kBACE;AAEJ;AAsBO,SAAS,oBAAoB,QAAgD,aAA+B;AACjH,MAAI,CAAC,OAAQ,QAAO,CAAC;AAErB,QAAM,QAAkB,CAAC;AAEzB,MAAI,OAAO,eAAe,GAAG;AAC3B,UAAM;AAAA,MACJ;AAAA,IAEF;AACA,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,cAAc,GAAG;AAC1B,UAAM,YAAY,OAAO,eAAe,OAAO,CAAC,YAAY,QAAQ,SAAS,EAAE,IAAI,CAAC,YAAY,QAAQ,GAAG;AAC3G,UAAM,YAAY,OAAO,eAAe,OAAO,CAAC,YAAY,CAAC,QAAQ,SAAS,EAAE,IAAI,CAAC,YAAY,QAAQ,GAAG;AAC5G,UAAM;AAAA,MACJ,GAAG,OAAO,WAAW,sBAAsB,OAAO,UAAU,wEAClD,OAAO,WAAW;AAAA,IAC9B;AACA,QAAI,UAAU,SAAS,GAAG;AACxB,YAAM;AAAA,QACJ,qBAAqB,UAAU,KAAK,IAAI,CAAC;AAAA,MAC3C;AAAA,IACF;AACA,QAAI,UAAU,SAAS,GAAG;AACxB,YAAM,KAAK,mEAA8D,UAAU,KAAK,IAAI,CAAC,GAAG;AAAA,IAClG;AAAA,EACF;AAEA,MAAI,OAAO,gBAAgB,GAAG;AAC5B,UAAM;AAAA,MACJ,GAAG,OAAO,aAAa,UAAU,OAAO,kBAAkB,IAAI,YAAY,WAAW;AAAA,IACvF;AAAA,EACF;AAEA,MAAI,gBAAgB,KAAK,OAAO,gBAAgB,KAAK,OAAO,kBAAkB,GAAG;AAC/E,UAAM;AAAA,MACJ,6BAA6B,OAAO,WAAW;AAAA,IACjD;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,aAAa,UAAoD;AAC/E,MAAI,YAAY,KAAM,QAAO;AAC7B,MAAI,YAAY,IAAK,QAAO;AAC5B,MAAI,YAAY,MAAM;AACpB,WAAO,yBAAyB,SAAS,QAAQ,CAAC,CAAC;AAAA,EACrD;AACA,SACE,yBAAyB,SAAS,QAAQ,CAAC,CAAC;AAGhD;AAEA,IAAM,sBAAsB,KAAK,KAAK,KAAK,KAAK;AAUzC,SAAS,cAAc,WAAsC,UAAkB,MAAM,KAAK,IAAI,GAAkB;AACrH,MAAI,CAAC,aAAa,MAAM,YAAY,oBAAqB,QAAO;AAChE,QAAM,OAAO,IAAI,KAAK,SAAS,EAAE,mBAAmB,SAAS,EAAE,OAAO,SAAS,KAAK,WAAW,UAAU,MAAM,CAAC;AAChH,SAAO,qCAAqC,IAAI,wFAAwF,QAAQ;AAClJ;AAEO,SAAS,YAAY,OAAuB;AACjD,MAAI,iBAAiB,UAAU;AAC7B,cAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,MAAM,MAAM,SAAS,MAAM,QAAQ,EAAE,CAAC;AAAA,EAC9E,OAAO;AACL,cAAU;AAAA,MACR,IAAI;AAAA,MACJ,OAAO,EAAE,MAAM,WAAW,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE;AAAA,IAC5F,CAAC;AAAA,EACH;AACA,UAAQ,KAAK,CAAC;AAChB;AAEO,SAAS,UAAU,OAAiD;AACzE,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,QAAQ,MACX,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,EACzB,OAAO,OAAO;AACjB,SAAO,MAAM,SAAS,IAAI,QAAQ;AACpC;AAEO,SAAS,YAAY,OAA+C;AACzE,MAAI,UAAU,UAAa,UAAU,GAAI,QAAO;AAChD,QAAM,SAAS,OAAO,KAAK;AAC3B,SAAO,OAAO,SAAS,MAAM,IAAI,SAAS;AAC5C;","names":[]}

package/dist/chunk-ZIXHS6AM.js

@@ -0,0 +1,42 @@
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+
+// src/lib/describeArgs.ts
+function describeTags(rawArgs, parsed) {
+  const given = repeatedValues(rawArgs, "tags", parsed);
+  if (given.length === 0) return void 0;
+  return given.flatMap((chunk) => chunk.split(",").map((tag) => tag.trim())).filter(Boolean);
+}
+function describeHints(noun, body) {
+  const search = noun === "images" ? "baker images library" : "baker videos search";
+  const hints = [];
+  if (body.description !== void 0) {
+    hints.push(
+      `The semantic index rebuilds in the background \u2014 a \`${search}\` run right now may still rank on the old description.`
+    );
+  }
+  if (body.tags !== void 0) {
+    hints.push(`--tags replaced the whole tag set. Run \`baker ${noun} get <id>\` first if you meant to add to it.`);
+  }
+  return hints.length > 0 ? hints : void 0;
+}
+function describeFields(args, rawArgs) {
+  const fields = {};
+  if (args.description) fields.description = args.description;
+  if (args.name) fields.name = args.name;
+  const tags = describeTags(rawArgs, args.tags);
+  if (tags !== void 0) fields.tags = tags;
+  return fields;
+}
+function describeErrorFix(code, noun) {
+  if (code !== "CONFLICT") return void 0;
+  return `Poll \`baker ${noun} get <id>\` until \`status\` reads "ready", then run this again. Do not retry immediately \u2014 the answer will not change until the analysis lands.`;
+}
+
+export {
+  describeHints,
+  describeFields,
+  describeErrorFix
+};
+//# sourceMappingURL=chunk-ZIXHS6AM.js.map

package/dist/chunk-ZIXHS6AM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/describeArgs.ts"],"sourcesContent":["import { repeatedValues } from \"./repeatedFlags.ts\";\n\n/**\n * The tag set a `describe` call was given, or `undefined` when the flag was\n * never passed.\n *\n * Both spellings land in the same place: `--tags a,b` and `--tags a --tags b`.\n * The repeated form has to be read off `rawArgs` because citty collapses a\n * repeated flag to its last value (see `repeatedFlags.ts`) — and on this\n * command that collapse is destructive rather than merely lossy, since the\n * write **replaces** the whole tag set. `--tags a --tags b` would have stored\n * `b` alone and reported success.\n *\n * An empty result is a real value, not a missing one: `--tags ,` clears the\n * set, which is the only way to say \"no tags\" once a wrong one is on the row.\n */\nexport function describeTags(rawArgs: readonly string[] | undefined, parsed: unknown): string[] | undefined {\n  const given = repeatedValues(rawArgs, \"tags\", parsed);\n  if (given.length === 0) return undefined;\n  return given.flatMap((chunk) => chunk.split(\",\").map((tag) => tag.trim())).filter(Boolean);\n}\n\n/**\n * The two things an agent gets wrong right after a `describe` call: searching\n * for the new wording immediately, and assuming `--tags` merged.\n */\nexport function describeHints(\n  noun: \"images\" | \"videos\",\n  body: { description?: string; tags?: string[] },\n): string[] | undefined {\n  // Named as the command the agent would actually run, not as the family —\n  // the two families do not spell their library search the same way.\n  const search = noun === \"images\" ? \"baker images library\" : \"baker videos search\";\n  const hints: string[] = [];\n  if (body.description !== undefined) {\n    hints.push(\n      `The semantic index rebuilds in the background — a \\`${search}\\` run right now may still rank on the old description.`,\n    );\n  }\n  if (body.tags !== undefined) {\n    hints.push(`--tags replaced the whole tag set. Run \\`baker ${noun} get <id>\\` first if you meant to add to it.`);\n  }\n  return hints.length > 0 ? hints : undefined;\n}\n\n/** The three fields a `describe` call may change, as the request carries them. */\nexport type DescribeFields = { name?: string; description?: string; tags?: string[] };\n\n/**\n * The fields a `describe` invocation is actually asking to change.\n *\n * A flag left off is absent rather than empty, because the mutation merges\n * against the stored row: sending `name: \"\"` for a flag the caller never typed\n * would blank it. `--description \"\"` is treated the same way — an empty string\n * is not a description anybody meant to write.\n */\nexport function describeFields(args: Record<string, unknown>, rawArgs: readonly string[] | undefined): DescribeFields {\n  const fields: DescribeFields = {};\n  if (args.description) fields.description = args.description as string;\n  if (args.name) fields.name = args.name as string;\n  const tags = describeTags(rawArgs, args.tags);\n  if (tags !== undefined) fields.tags = tags;\n  return fields;\n}\n\n/**\n * Remediation for the one refusal the agent can act on rather than report.\n *\n * `CONFLICT` means the row is still being analysed, and the analysis overwrites\n * `name` / `description` / `tags` when it lands — so an immediate retry cannot\n * succeed, and saying so is the difference between one wasted call and a loop.\n */\nexport function describeErrorFix(code: string, noun: \"images\" | \"videos\"): string | undefined {\n  if (code !== \"CONFLICT\") return undefined;\n  return `Poll \\`baker ${noun} get <id>\\` until \\`status\\` reads \"ready\", then run this again. Do not retry immediately — the answer will not change until the analysis lands.`;\n}\n"],"mappings":";;;;;AAgBO,SAAS,aAAa,SAAwC,QAAuC;AAC1G,QAAM,QAAQ,eAAe,SAAS,QAAQ,MAAM;AACpD,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,SAAO,MAAM,QAAQ,CAAC,UAAU,MAAM,MAAM,GAAG,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,EAAE,OAAO,OAAO;AAC3F;AAMO,SAAS,cACd,MACA,MACsB;AAGtB,QAAM,SAAS,SAAS,WAAW,yBAAyB;AAC5D,QAAM,QAAkB,CAAC;AACzB,MAAI,KAAK,gBAAgB,QAAW;AAClC,UAAM;AAAA,MACJ,4DAAuD,MAAM;AAAA,IAC/D;AAAA,EACF;AACA,MAAI,KAAK,SAAS,QAAW;AAC3B,UAAM,KAAK,kDAAkD,IAAI,8CAA8C;AAAA,EACjH;AACA,SAAO,MAAM,SAAS,IAAI,QAAQ;AACpC;AAaO,SAAS,eAAe,MAA+B,SAAwD;AACpH,QAAM,SAAyB,CAAC;AAChC,MAAI,KAAK,YAAa,QAAO,cAAc,KAAK;AAChD,MAAI,KAAK,KAAM,QAAO,OAAO,KAAK;AAClC,QAAM,OAAO,aAAa,SAAS,KAAK,IAAI;AAC5C,MAAI,SAAS,OAAW,QAAO,OAAO;AACtC,SAAO;AACT;AASO,SAAS,iBAAiB,MAAc,MAA+C;AAC5F,MAAI,SAAS,WAAY,QAAO;AAChC,SAAO,gBAAgB,IAAI;AAC7B;","names":[]}