@koda-sl/baker-cli 0.470.0-dev.fb31086c9 → 0.471.0

package/dist/chunk-4LXKCSWY.js

@@ -0,0 +1,455 @@
+import {
+  parseBrandTokens
+} from "./chunk-4C7SIRHL.js";
+
+// src/engine/brand/fonts.ts
+import { posix } from "path";
+var GOOGLE_CSS2 = "https://fonts.googleapis.com/css2";
+function parseGoogleFontFaces(css) {
+  const faces = [];
+  const re = /\/\*\s*([\w-]+)\s*\*\/\s*@font-face\s*\{([^}]*)\}/g;
+  for (const match of String(css).matchAll(re)) {
+    const subset = match[1] ?? "";
+    const body = match[2] ?? "";
+    const family = body.match(/font-family\s*:\s*['"]?([^'";]+)['"]?\s*;/i)?.[1]?.trim();
+    const url = body.match(/src\s*:\s*url\(\s*['"]?([^'")]+)['"]?\s*\)/i)?.[1]?.trim();
+    const weight = body.match(/font-weight\s*:\s*(\d{3})\s*;/i)?.[1];
+    if (!family || !url || !weight) continue;
+    faces.push({
+      subset,
+      family,
+      style: body.match(/font-style\s*:\s*([\w-]+)\s*;/i)?.[1]?.trim() ?? "normal",
+      weight: Number(weight),
+      url,
+      unicodeRange: body.match(/unicode-range\s*:\s*([^;]+);/i)?.[1]?.trim() ?? ""
+    });
+  }
+  return faces;
+}
+function fontFileName(face) {
+  const family = face.family.replace(/[^A-Za-z0-9]/g, "");
+  const style = face.style === "italic" ? "italic" : "";
+  return `${family}-${face.weight}${style}-${face.subset}.woff2`;
+}
+function fontFaceHref(face) {
+  return `../brand/fonts/${fontFileName(face)}`;
+}
+function renderFontFaceCss(faces) {
+  return faces.map(
+    (face) => [
+      "@font-face {",
+      `  font-family: '${face.family}';`,
+      `  font-style: ${face.style};`,
+      `  font-weight: ${face.weight};`,
+      "  font-display: swap;",
+      `  src: url('${fontFaceHref(face)}') format('woff2');`,
+      ...face.unicodeRange ? [`  unicode-range: ${face.unicodeRange};`] : [],
+      "}"
+    ].join("\n")
+  ).join("\n");
+}
+var FONT_PROVIDERS = ["google", "fontsource"];
+var FONTSOURCE_API = "https://api.fontsource.org/v1";
+var FONT_STYLES = ["normal", "italic"];
+var ITAL_AXIS = { normal: 0, italic: 1 };
+function fontsourceId(family) {
+  return family.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function fontsourceFaces(meta, weights, subsets, styles = ["normal"]) {
+  const faces = [];
+  for (const subset of subsets.filter((s) => meta.subsets.includes(s))) {
+    for (const weight of weights.filter((w) => meta.weights.includes(w))) {
+      for (const style of styles.filter((style2) => meta.styles.includes(style2))) {
+        const url = meta.variants[String(weight)]?.[style]?.[subset]?.url?.woff2;
+        if (!url) continue;
+        faces.push({
+          subset,
+          family: meta.family,
+          style,
+          weight,
+          url,
+          unicodeRange: meta.unicodeRange?.[subset] ?? "",
+          provider: "fontsource"
+        });
+      }
+    }
+  }
+  return faces;
+}
+function undisambiguatedSubsets(faces) {
+  if (new Set(faces.map((face) => face.subset)).size < 2) return [];
+  return [...new Set(faces.filter((face) => !face.unicodeRange).map((face) => face.subset))];
+}
+function suggestFamilies(wanted, catalogue, limit = 5) {
+  const key = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
+  const target = key(wanted);
+  if (!target) return [];
+  const words = target.split(" ");
+  const scored = catalogue.map((family) => {
+    const candidate = key(family);
+    if (candidate === target) return { family, score: 0 };
+    if (candidate.startsWith(target)) return { family, score: 1 };
+    if (candidate.includes(target)) return { family, score: 2 };
+    const shared = words.filter((w) => w.length > 2 && candidate.includes(w)).length;
+    return { family, score: shared > 0 ? 3 + (words.length - shared) : Number.POSITIVE_INFINITY };
+  }).filter((c) => Number.isFinite(c.score)).sort((a, b) => a.score - b.score || a.family.localeCompare(b.family));
+  return scored.slice(0, limit).map((c) => c.family);
+}
+function asFontsourceMeta(body) {
+  if (typeof body !== "object" || body === null) return null;
+  const meta = body;
+  const ok = typeof meta.family === "string" && Array.isArray(meta.weights) && Array.isArray(meta.styles) && Array.isArray(meta.subsets) && typeof meta.variants === "object" && meta.variants !== null;
+  return ok ? meta : null;
+}
+async function probeGoogleFaces(family, lookup) {
+  const got = await lookup(googleFontCssUrl(family, STANDARD_WEIGHTS, FONT_STYLES));
+  if (got.status === "unreachable") return null;
+  return got.status === "served" ? parseGoogleFontFaces(got.css) : [];
+}
+async function resolveFromGoogle(family, weights, subsets, styles, deps) {
+  const google = await deps.lookupGoogleCss(googleFontCssUrl(family, weights, FONT_STYLES));
+  if (google.status === "unreachable") return { ok: false, reason: "unreachable", provider: "google" };
+  if (google.status === "absent") {
+    const served2 = await probeGoogleFaces(family, deps.lookupGoogleCss);
+    if (served2 === null) return { ok: false, reason: "unreachable", provider: "google" };
+    const available = [...new Set(served2.map((face) => face.weight))].sort((a, b) => a - b);
+    return available.length > 0 ? { ok: false, reason: "weight", provider: "google", available } : null;
+  }
+  const served = parseGoogleFontFaces(google.css);
+  if (served.length === 0) return null;
+  const availableStyles = [...new Set(served.map((face) => face.style))].sort();
+  const inSubset = served.filter((face) => subsets.includes(face.subset));
+  const faces = inSubset.filter((face) => styles.includes(face.style)).map((face) => ({ ...face, provider: "google" }));
+  if (faces.length > 0) return { ok: true, provider: "google", faces, availableStyles };
+  return { ok: false, reason: "subset", provider: "google", available: [...new Set(served.map((f) => f.subset))] };
+}
+async function resolveBrandFaces(family, weights, subsets, deps, styles = ["normal"]) {
+  const google = await resolveFromGoogle(family, weights, subsets, styles, deps);
+  if (google) return google;
+  let body;
+  try {
+    body = await deps.fetchJson(`${FONTSOURCE_API}/fonts/${fontsourceId(family)}`);
+  } catch {
+    return { ok: false, reason: "unreachable", provider: "fontsource" };
+  }
+  const meta = asFontsourceMeta(body);
+  if (meta) {
+    const faces = fontsourceFaces(meta, weights, subsets, styles);
+    const ambiguous = undisambiguatedSubsets(faces);
+    if (ambiguous.length > 0) {
+      return { ok: false, reason: "ambiguous-subsets", provider: "fontsource", available: meta.subsets };
+    }
+    if (faces.length > 0) return { ok: true, provider: "fontsource", faces, availableStyles: [...meta.styles].sort() };
+    if (!subsets.some((subset) => meta.subsets.includes(subset))) {
+      return { ok: false, reason: "subset", provider: "fontsource", available: meta.subsets };
+    }
+    return { ok: false, reason: "weight", provider: "fontsource", available: meta.weights };
+  }
+  return { ok: false, reason: "unknown-family" };
+}
+function rebaseFontFaceSrc(block, fromDir, toDir = "src/styles") {
+  return block.replace(/url\(\s*(['"]?)([^'")]+)\1\s*\)/gi, (whole, _quote, href) => {
+    if (!isRepoFontHref(href)) return whole;
+    const target = posix.normalize(posix.join(fromDir, href));
+    return `url('${posix.relative(toDir, target)}')`;
+  });
+}
+function declaredFontFaces(source) {
+  const out = [];
+  for (const rule of stripCssComments(source).matchAll(/@font-face\s*\{[^}]*\}/gi)) {
+    const family = rule[0].match(/font-family\s*:\s*([^;]+)/i)?.[1];
+    if (!family || rule.index === void 0) continue;
+    out.push({ family: normalizeFamily(family), block: source.slice(rule.index, rule.index + rule[0].length) });
+  }
+  return out;
+}
+function isRepoFontHref(href) {
+  return !/^(?:data:|https?:|\/)/i.test(href);
+}
+function missingFontFiles(urls, available) {
+  return urls.filter(isRepoFontHref).map((url) => posix.basename(url.split("?")[0] ?? "")).filter((file) => !available.has(file));
+}
+function planFontAdoption(sources, families) {
+  const wanted = new Map(families.map((family) => [normalizeFamily(family), family]));
+  const byFamily = /* @__PURE__ */ new Map();
+  for (const { path, source } of sources) {
+    const dir = posix.dirname(path);
+    for (const face of declaredFontFaces(source)) {
+      if (!wanted.has(face.family)) continue;
+      const perFile = byFamily.get(face.family) ?? /* @__PURE__ */ new Map();
+      perFile.set(path, [...perFile.get(path) ?? [], rebaseFontFaceSrc(face.block, dir)]);
+      byFamily.set(face.family, perFile);
+    }
+  }
+  const plans = [];
+  const conflicts = [];
+  for (const [family, perFile] of byFamily) {
+    const display = wanted.get(family) ?? family;
+    const files = [...perFile.keys()];
+    const shapes = new Set([...perFile.values()].map((blocks2) => blocks2.join("\n")));
+    if (shapes.size > 1) {
+      conflicts.push({ family: display, files });
+      continue;
+    }
+    const blocks = perFile.get(files[0] ?? "") ?? [];
+    const urls = blocks.flatMap(
+      (block) => [...block.matchAll(/url\(\s*['"]?([^'")]+)['"]?\s*\)/gi)].map((m) => m[1] ?? "")
+    );
+    plans.push({ family: display, blocks, files, urls });
+  }
+  return { plans, conflicts };
+}
+async function fontsourceCatalogue(deps) {
+  const body = await deps.fetchJson(`${FONTSOURCE_API}/fonts`).catch(() => null);
+  if (!Array.isArray(body)) return [];
+  return body.map((entry) => typeof entry === "object" && entry !== null ? entry.family : null).filter((family) => typeof family === "string");
+}
+function parseWeightAxis(spec) {
+  const axis = spec.match(/wght@([^&]+)/i)?.[1] ?? "";
+  const weights = /* @__PURE__ */ new Set();
+  for (const tuple of axis.split(";")) {
+    const last = tuple.split(",").pop()?.trim() ?? "";
+    const range = last.match(/^(\d{3})\.\.(\d{3})$/);
+    if (range) {
+      for (let w = Number(range[1]); w <= Number(range[2]); w += 100) weights.add(w);
+    } else if (/^\d{3}$/.test(last)) {
+      weights.add(Number(last));
+    }
+  }
+  return [...weights].sort((a, b) => a - b);
+}
+function googleFontRequests(css) {
+  const out = [];
+  for (const link of String(css).matchAll(/fonts\.googleapis\.com\/[^\s"')]+/gi)) {
+    for (const param of link[0].matchAll(/[?&]family=([^&]+)/gi)) {
+      const [namePart, ...specParts] = (param[1] ?? "").split(":");
+      const family = decodeURIComponent((namePart ?? "").replaceAll("+", " ")).trim();
+      if (!family) continue;
+      out.push({ family, weights: parseWeightAxis(specParts.join(":")) });
+    }
+  }
+  return out;
+}
+function resolveFetchWeights(flag, declared) {
+  if (flag) {
+    return String(flag).split(",").map((w) => Number(w.trim())).filter((w) => Number.isInteger(w) && w >= 100 && w <= 900);
+  }
+  return declared?.length ? declared : [400];
+}
+var DEFAULT_SUBSETS = ["latin"];
+function resolveFetchSubsets(flag, selfHosted) {
+  const asked = String(flag ?? "").split(",").map((subset) => subset.trim()).filter(Boolean);
+  const named = flag ? [...new Set(asked)] : selfHosted;
+  return named.length > 0 ? named : [...DEFAULT_SUBSETS];
+}
+function resolveFetchStyles(italic, selfHosted) {
+  return italic || selfHosted.includes("italic") ? ["normal", "italic"] : ["normal"];
+}
+function googleFontCssUrl(family, weights, styles = ["normal"]) {
+  const name = family.trim().split(/\s+/).map(encodeURIComponent).join("+");
+  const sorted = [...new Set(weights)].sort((a, b) => a - b);
+  if (sorted.length === 0) return `${GOOGLE_CSS2}?family=${name}&display=swap`;
+  const wanted = FONT_STYLES.filter((style) => styles.includes(style));
+  const spec = wanted.length > 1 ? `${name}:ital,wght@${wanted.flatMap((style) => sorted.map((w) => `${ITAL_AXIS[style]},${w}`)).join(";")}` : `${name}:wght@${sorted.join(";")}`;
+  return `${GOOGLE_CSS2}?family=${spec}&display=swap`;
+}
+var STANDARD_WEIGHTS = [100, 200, 300, 400, 500, 600, 700, 800, 900];
+async function probeServedWeights(family, fetchCss) {
+  const css = await fetchCss(googleFontCssUrl(family, STANDARD_WEIGHTS));
+  if (css === null) return [];
+  return [...new Set(parseGoogleFontFaces(css).map((face) => face.weight))].sort((a, b) => a - b);
+}
+async function checkFontRequests(requests, fetchCss) {
+  const results = [];
+  for (const request of requests) {
+    const css = await fetchCss(googleFontCssUrl(request.family, request.weights));
+    if (css === null) {
+      const served2 = await probeServedWeights(request.family, fetchCss);
+      results.push({
+        family: request.family,
+        requested: request.weights,
+        served: served2,
+        missing: request.weights.filter((w) => !served2.includes(w)),
+        subsets: [],
+        cause: served2.length === 0 ? "unknown-family" : "unavailable-weight"
+      });
+      continue;
+    }
+    const faces = parseGoogleFontFaces(css);
+    const served = [...new Set(faces.map((f) => f.weight))].sort((a, b) => a - b);
+    results.push({
+      family: request.family,
+      requested: request.weights,
+      served,
+      missing: request.weights.filter((w) => !served.includes(w)),
+      subsets: [...new Set(faces.map((f) => f.subset))]
+    });
+  }
+  return results;
+}
+var GENERIC_FAMILIES = /* @__PURE__ */ new Set([
+  "sans-serif",
+  "serif",
+  "monospace",
+  "cursive",
+  "fantasy",
+  "system-ui",
+  "ui-sans-serif",
+  "ui-serif",
+  "ui-monospace",
+  "ui-rounded",
+  "arial",
+  "helvetica",
+  "georgia",
+  "times",
+  "courier",
+  "inherit",
+  "initial",
+  "unset"
+]);
+function stripCssComments(css) {
+  return css.replace(/\/\*[\s\S]*?\*\//g, (block) => block.replace(/[^\n]/g, " "));
+}
+function normalizeFamily(raw) {
+  return raw.trim().replace(/^['"]|['"]$/g, "").trim().toLowerCase();
+}
+function fontFaceFamilies(css) {
+  const out = /* @__PURE__ */ new Set();
+  for (const rule of stripCssComments(css).matchAll(/@font-face\s*\{([^}]*)\}/gi)) {
+    const family = (rule[1] ?? "").match(/font-family\s*:\s*([^;]+)/i)?.[1];
+    if (family) out.add(normalizeFamily(family));
+  }
+  return out;
+}
+function declaredWeights(body) {
+  const spec = (body.match(/font-weight\s*:\s*([^;}]+)/i)?.[1] ?? "").match(/\d{3}/g) ?? [];
+  if (spec.length !== 2) return spec.map(Number);
+  const range = [];
+  for (let w = Number(spec[0]); w <= Number(spec[1]); w += 100) range.push(w);
+  return range;
+}
+function selfHostedWeights(css, family) {
+  const target = normalizeFamily(family);
+  const weights = /* @__PURE__ */ new Set();
+  for (const rule of stripCssComments(css).matchAll(/@font-face\s*\{([^}]*)\}/gi)) {
+    const body = rule[1] ?? "";
+    const declared = body.match(/font-family\s*:\s*([^;]+)/i)?.[1];
+    if (!declared || normalizeFamily(declared) !== target) continue;
+    for (const weight of declaredWeights(body)) weights.add(weight);
+  }
+  return [...weights].sort((a, b) => a - b);
+}
+function fontFileSubset(href) {
+  const file = posix.basename((href.split("?")[0] ?? "").split("#")[0] ?? "");
+  return /^[A-Za-z0-9]+-[1-9]00(?:italic)?-([\w-]+)\.woff2$/.exec(file)?.[1] ?? null;
+}
+function selfHostedSubsets(css, family) {
+  const target = normalizeFamily(family);
+  const subsets = /* @__PURE__ */ new Set();
+  for (const rule of stripCssComments(css).matchAll(/@font-face\s*\{([^}]*)\}/gi)) {
+    const body = rule[1] ?? "";
+    const declared = body.match(/font-family\s*:\s*([^;]+)/i)?.[1];
+    if (!declared || normalizeFamily(declared) !== target) continue;
+    for (const url of body.matchAll(/url\(\s*['"]?([^'")]+)['"]?\s*\)/gi)) {
+      const subset = fontFileSubset(url[1] ?? "");
+      if (subset) subsets.add(subset);
+    }
+  }
+  return [...subsets].sort();
+}
+function selfHostedStyles(css, family) {
+  const target = normalizeFamily(family);
+  const styles = /* @__PURE__ */ new Set();
+  for (const rule of stripCssComments(css).matchAll(/@font-face\s*\{([^}]*)\}/gi)) {
+    const body = rule[1] ?? "";
+    const declared = body.match(/font-family\s*:\s*([^;]+)/i)?.[1];
+    if (declared && normalizeFamily(declared) === target) styles.add(faceStyle(body));
+  }
+  return [...styles].sort();
+}
+function fontsourceFamilies(css) {
+  const out = /* @__PURE__ */ new Set();
+  for (const imported of stripCssComments(css).matchAll(/@fontsource(-variable)?\/([\w-]+)/gi)) {
+    const slug = imported[2];
+    if (!slug) continue;
+    out.add(`${slug.replaceAll("-", " ")}${imported[1] ? " variable" : ""}`.toLowerCase());
+  }
+  return out;
+}
+function asAuthored(css, normalized) {
+  const escaped = normalized.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const text = stripCssComments(css);
+  return text.match(new RegExp(`["']${escaped}["']`, "i"))?.[0]?.slice(1, -1) ?? text.match(new RegExp(`(?<![\\w-])${escaped}(?![\\w-])`, "i"))?.[0] ?? normalized;
+}
+function unresolvedBrandFamilies(css) {
+  const declared = [...parseBrandTokens(css).fonts].filter((family) => !GENERIC_FAMILIES.has(family));
+  const loaded = fontFaceFamilies(css);
+  return declared.filter((family) => !loaded.has(family)).map((family) => asAuthored(css, family));
+}
+function stripFontFaceBlocks(source, family, styles) {
+  const target = normalizeFamily(family);
+  const ranges = [];
+  for (const rule of stripCssComments(source).matchAll(/@font-face\s*\{([^}]*)\}/gi)) {
+    const body = rule[1] ?? "";
+    const declared = body.match(/font-family\s*:\s*([^;]+)/i)?.[1];
+    if (!declared || normalizeFamily(declared) !== target || rule.index === void 0) continue;
+    if (styles && !styles.has(faceStyle(body))) continue;
+    ranges.push([rule.index, rule.index + rule[0].length]);
+  }
+  let out = source;
+  for (const [start, end] of ranges.reverse()) out = `${out.slice(0, start)}${out.slice(end)}`;
+  return out.replace(/\n{3,}/g, "\n\n");
+}
+function faceStyle(body) {
+  return body.match(/font-style\s*:\s*([\w-]+)/i)?.[1]?.trim().toLowerCase() ?? "normal";
+}
+function declaredStyles(block) {
+  const styles = /* @__PURE__ */ new Set();
+  for (const rule of stripCssComments(block).matchAll(/@font-face\s*\{([^}]*)\}/gi))
+    styles.add(faceStyle(rule[1] ?? ""));
+  return styles;
+}
+function upsertFontFaceCss(css, family, block) {
+  const styles = declaredStyles(block);
+  const out = stripFontFaceBlocks(css, family, styles.size > 0 ? styles : void 0);
+  const themeAt = stripCssComments(out).search(/@theme\b/);
+  if (themeAt < 0) return `${out.trimEnd()}
+
+${block}
+`;
+  const head = out.slice(0, themeAt).trimEnd();
+  const tail = out.slice(themeAt);
+  return head ? `${head}
+
+${block}
+
+${tail}` : `${block}
+
+${tail}`;
+}
+
+export {
+  fontFileName,
+  renderFontFaceCss,
+  FONT_PROVIDERS,
+  suggestFamilies,
+  resolveBrandFaces,
+  missingFontFiles,
+  planFontAdoption,
+  fontsourceCatalogue,
+  googleFontRequests,
+  resolveFetchWeights,
+  DEFAULT_SUBSETS,
+  resolveFetchSubsets,
+  resolveFetchStyles,
+  checkFontRequests,
+  GENERIC_FAMILIES,
+  selfHostedWeights,
+  selfHostedSubsets,
+  selfHostedStyles,
+  fontsourceFamilies,
+  unresolvedBrandFamilies,
+  stripFontFaceBlocks,
+  upsertFontFaceCss
+};
+//# sourceMappingURL=chunk-4LXKCSWY.js.map

package/dist/chunk-4O6LGCXP.js

@@ -0,0 +1,35 @@
+import {
+  ApiError
+} from "./chunk-CK5ZNZ3I.js";
+import {
+  writeJson
+} from "./chunk-KCA5CDCU.js";
+
+// src/commands/winning-ads/shared.ts
+function splitList(value) {
+  if (!value) {
+    return [];
+  }
+  return value.split(",").map((v) => v.trim()).filter(Boolean);
+}
+function reportError(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);
+}
+var PLATFORM_NAMES = {
+  meta: "Meta",
+  linkedin: "LinkedIn",
+  tiktok: "TikTok",
+  google: "Google Ads"
+};
+
+export {
+  splitList,
+  reportError,
+  PLATFORM_NAMES
+};
+//# sourceMappingURL=chunk-4O6LGCXP.js.map

package/dist/chunk-53DV3HBZ.js

@@ -0,0 +1,172 @@
+import {
+  ACTION_TEMP_ID_PREFIX
+} from "./chunk-XABVEMC3.js";
+import {
+  ApiError
+} from "./chunk-CK5ZNZ3I.js";
+import {
+  writeJson
+} from "./chunk-KCA5CDCU.js";
+
+// src/commands/actions/tagError.ts
+var UNKNOWN_TAG_RE = /Unknown action tag\(s\): ([^.]+)\. Valid tags: ([^.]+)\./;
+function splitSlugs(list) {
+  return list.split(",").map((slug) => slug.trim()).filter((slug) => slug.length > 0);
+}
+function actionTagFix(message) {
+  const match = UNKNOWN_TAG_RE.exec(message);
+  if (!match) {
+    return null;
+  }
+  const [, unknownList, validList] = match;
+  const unknownTags = splitSlugs(unknownList ?? "");
+  const validTags = splitSlugs(validList ?? "");
+  const first = unknownTags[0];
+  if (first === void 0 || validTags.length === 0) {
+    return null;
+  }
+  return {
+    action: "retry_with_a_valid_tag",
+    explanation: `The tag(s) ${unknownTags.join(", ")} are not in this company's taxonomy. \`validTags\` below is the complete accepted set \u2014 pick from it and re-run the same command. Only mint a new tag when none of them names this work; a near-duplicate of an existing tag splits the backlog's filter instead of extending it.`,
+    unknownTags,
+    validTags,
+    mintCommand: `baker actions tags create --slug ${first} --description "<what ${first} groups>"`,
+    listCommand: "baker actions tags list"
+  };
+}
+
+// src/commands/actions/shared.ts
+function writeOk(data) {
+  writeJson({ ok: true, data: data ?? null });
+}
+function failValidation(message) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function failApi(err) {
+  if (err instanceof ApiError) {
+    const fix = actionTagFix(err.message);
+    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
+    process.exit(1);
+  }
+  if (err instanceof Error) {
+    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function generateTempId() {
+  return `${ACTION_TEMP_ID_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function isTempId(id) {
+  return id.startsWith(ACTION_TEMP_ID_PREFIX);
+}
+function parseTagList(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const tags = value.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+  return [...new Set(tags)];
+}
+var ACTION_PRIORITIES = ["urgent", "high", "medium", "low"];
+function parsePriority(value, { allowClear }) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    failValidation(
+      `--priority must be one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+    );
+  }
+  const trimmed = value.trim().toLowerCase();
+  if (trimmed === "") {
+    if (allowClear) {
+      return null;
+    }
+    return void 0;
+  }
+  if (allowClear && (trimmed === "none" || trimmed === "clear")) {
+    return null;
+  }
+  if (ACTION_PRIORITIES.includes(trimmed)) {
+    return trimmed;
+  }
+  failValidation(
+    `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+  );
+}
+var FAN_OUT_NUDGE_THRESHOLD = 2;
+var FAN_OUT_THRESHOLD = 3;
+function buildCreateHints({
+  advisory,
+  description,
+  tempId,
+  tags,
+  prioritySet,
+  draftCreateCount
+}) {
+  const hints = [];
+  if (advisory) {
+    hints.push(
+      `${advisory.hint} If nothing actually blocks it: baker actions draft remove ${tempId}, then do the work.`
+    );
+  }
+  if (draftCreateCount >= FAN_OUT_THRESHOLD) {
+    hints.push(
+      `${draftCreateCount} Tasks are staged in this chat. Re-read them with \`baker actions draft\`: can any be done now with a surface you already have, and do any two touch the same system (same container, same campaign, same page)? Those belong in ONE Task \u2014 fold them together with \`baker actions update\` and drop the extras with \`baker actions draft remove <tempId>\`.`
+    );
+  } else if (draftCreateCount === FAN_OUT_NUDGE_THRESHOLD) {
+    hints.push(
+      `Second Task staged in this chat. If these two land on the same system (same container, same campaign, same page) they are ONE Task \u2014 fold them with \`baker actions update\` and drop the extra with \`baker actions draft remove ${tempId}\`.`
+    );
+  }
+  hints.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);
+  if (!description) {
+    hints.push("Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)");
+  }
+  if (!tags || tags.length === 0) {
+    hints.push(
+      "MISSING --tags. This action is invisible to the backlog's tag filter. Re-run with --tags <slug,...> (`baker actions tags list` for the taxonomy, `baker actions tags create --slug <slug>` to mint) \u2014 or `baker actions update <tempId> --tags <slug,...>`."
+    );
+  }
+  if (!prioritySet) {
+    hints.push(
+      `MISSING --priority. Without it this action ranks as 'normal' (medium) in the do-first ordering, so urgent/high client work won't surface first. Re-run with --priority ${ACTION_PRIORITIES.join("|")} \u2014 or \`baker actions update <tempId> --priority <level>\`.`
+    );
+  }
+  return hints;
+}
+var ACTIONS_LIST_DEFAULT_LIMIT = 500;
+function buildListHints({ returned, limit }) {
+  if (returned < limit) {
+    return [];
+  }
+  return [
+    `This list is capped at ${limit} Tasks and came back full, so older Tasks exist that are NOT shown. Do not treat it as the whole backlog \u2014 re-run with --limit ${limit * 2} (or narrow with --status / --search).`
+  ];
+}
+function buildGetHints(detail) {
+  if (detail?.action.status !== "pending" || detail.activeChat !== null) {
+    return [];
+  }
+  return [
+    `If you are working on this Task in this chat, claim it first so the Tasks page shows it in progress: baker actions claim ${detail.action._id}`
+  ];
+}
+
+export {
+  writeOk,
+  failValidation,
+  failApi,
+  generateTempId,
+  isTempId,
+  parseTagList,
+  ACTION_PRIORITIES,
+  parsePriority,
+  buildCreateHints,
+  ACTIONS_LIST_DEFAULT_LIMIT,
+  buildListHints,
+  buildGetHints
+};
+//# sourceMappingURL=chunk-53DV3HBZ.js.map