@koda-sl/baker-cli 0.489.0-dev.63e618e80 → 0.490.0

package/dist/check-SLNHVYGS.js

@@ -0,0 +1,104 @@
+import {
+  readAdWords,
+  ruleRefusal
+} from "./chunk-LXQB4ZGE.js";
+import "./chunk-PTGYM4J6.js";
+import "./chunk-LCW3U4EA.js";
+import {
+  readAllRules
+} from "./chunk-VD73V44J.js";
+import {
+  ruleTells
+} from "./chunk-G2LGMWNG.js";
+import "./chunk-JYALBYN7.js";
+import "./chunk-5WMTPYKT.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-23H4ZJRP.js";
+import "./chunk-4AMIHNNP.js";
+import {
+  selectRules
+} from "./chunk-IKCP5NCE.js";
+import "./chunk-MCJ5I5LR.js";
+import {
+  marketFromCompanyDoc
+} from "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-DWX44QL6.js";
+import "./chunk-2FSEESJU.js";
+import "./chunk-CVBKW75S.js";
+import "./chunk-BLAHHMPF.js";
+import "./chunk-66QHX566.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-WTJSMYY2.js";
+import "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/check.ts
+import { readdir, readFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+var DESCRIPTION = `Read every creative already made against the company's rules as they stand now: which ads say words a rule bans, or leave out words a rule requires. Run it after adding a rule (\`baker creatives rules add\`); nothing is re-rendered or marked stale, so ask the person which ads to correct.
+Start here: baker creatives check
+  baker creatives check --slug mba-ia-online   # one creative`;
+var ARGS = {
+  slug: { type: "string", description: "One creative (src/creatives/<slug>/); left out, every one", required: false }
+};
+registerSchema({ command: "creatives.check", description: DESCRIPTION, args: ARGS });
+function checkCreatives(ads, rules, companyLanguage) {
+  const breaking = ads.flatMap(({ slug, ad }) => {
+    const held = selectRules(
+      rules,
+      {
+        kind: ad.kind,
+        ...ad.product ? { product: ad.product } : {},
+        ...ad.platform ? { platform: ad.platform } : {},
+        ...ad.platforms ? { platforms: ad.platforms } : {}
+      },
+      ad.waived
+    );
+    const refusal = ruleRefusal(ruleTells(ad.lines, held, ad.language ?? companyLanguage));
+    return refusal ? [{ creative: slug, broken: refusal.problems }] : [];
+  });
+  return { checked: ads.length, breaking };
+}
+async function readAds(root, slug) {
+  const dir = path.join(root, "src", "creatives");
+  const slugs = slug ? [slug] : (await readdir(dir, { withFileTypes: true }).catch(() => [])).filter((e) => e.isDirectory() && !e.name.startsWith("_")).map((e) => e.name).sort();
+  const ads = await Promise.all(slugs.map(async (s) => ({ slug: s, ad: await readAdWords(path.join(dir, s)) })));
+  return ads.flatMap(({ slug: s, ad }) => ad ? [{ slug: s, ad }] : []);
+}
+var checkCommand = defineCommand({
+  meta: { name: "check", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const slug = typeof args.slug === "string" && args.slug ? args.slug : void 0;
+    const [ads, rules, companyDoc] = await Promise.all([
+      readAds(root, slug),
+      readAllRules(root),
+      readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => null)
+    ]);
+    const report = checkCreatives(ads, rules, marketFromCompanyDoc(companyDoc)?.language);
+    writeJson({
+      ok: true,
+      data: report,
+      hints: report.breaking.length > 0 ? [
+        `${report.breaking.length} of ${report.checked} ads break a rule now in force. Tell the person which, and correct only the ones they want: edit the words in that ad's prompt.json and run it again, or waive the rule there if the person asked for those words.`
+      ] : [`None of the ${report.checked} ads breaks a wording rule now in force.`]
+    });
+  }
+});
+export {
+  checkCommand,
+  checkCreatives
+};
+//# sourceMappingURL=check-SLNHVYGS.js.map

package/dist/chunk-2C7AHPM4.js

@@ -0,0 +1,191 @@
+import {
+  writeAdsOutput
+} from "./chunk-SWL4AAPP.js";
+import {
+  asRecord,
+  shapeListRows
+} from "./chunk-65Y3RCWP.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.js";
+
+// src/commands/ads/meta/list-rows.ts
+function pick(row, keys) {
+  const picked = {};
+  for (const key of keys) {
+    if (row[key] !== void 0) picked[key] = row[key];
+  }
+  return picked;
+}
+var CAMPAIGN_COLUMNS = ["id", "name", "effective_status", "daily_budget", "lifetime_budget", "created_date"];
+var DIAGNOSTIC_COLUMNS = ["issues", "suggestions"];
+function compactCampaign(row) {
+  const created = row.created_time;
+  return {
+    ...pick(row, ["id", "name", "effective_status", "daily_budget", "lifetime_budget"]),
+    ...typeof created === "string" ? { created_date: created.slice(0, 10) } : {},
+    ...diagnostics(row)
+  };
+}
+var ADSET_KEYS = [
+  "id",
+  "name",
+  "campaign_id",
+  "effective_status",
+  "optimization_goal",
+  "billing_event",
+  "bid_strategy",
+  "daily_budget",
+  "lifetime_budget",
+  "destination_type",
+  // A Dynamic Creative ad set refuses every new ad, which changes the plan before anything is staged.
+  "is_dynamic_creative"
+];
+var ADSET_COLUMNS = [...ADSET_KEYS, "learning_stage", "end_time", "created_time"];
+function compactAdSet(row) {
+  const learning = asRecord(row.learning_stage_info)?.status;
+  return {
+    ...pick(row, ADSET_KEYS),
+    ...typeof learning === "string" ? { learning_stage: learning } : {},
+    ...pick(row, ["end_time", "created_time"]),
+    ...diagnostics(row)
+  };
+}
+var AD_COLUMNS = [
+  "id",
+  "name",
+  "adset_id",
+  "campaign_id",
+  "effective_status",
+  "creative_id",
+  "issues",
+  "created_time"
+];
+function adIssues(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const issue = asRecord(entry);
+    const text = issue?.error_summary ?? issue?.error_message;
+    return typeof text === "string" && text ? [text] : [];
+  });
+}
+function suggestions(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const recommendation = asRecord(entry);
+    const text = recommendation?.title ?? recommendation?.message;
+    return typeof text === "string" && text ? [text] : [];
+  });
+}
+function diagnostics(row) {
+  const issues = adIssues(row.issues_info);
+  const suggested = suggestions(row.recommendations);
+  return {
+    ...issues.length > 0 ? { issues } : {},
+    ...suggested.length > 0 ? { suggestions: suggested } : {}
+  };
+}
+function compactAd(row) {
+  const creativeId = asRecord(row.creative)?.id;
+  const issues = adIssues(row.issues_info);
+  return {
+    ...pick(row, ["id", "name", "adset_id", "campaign_id", "effective_status"]),
+    ...creativeId !== void 0 ? { creative_id: creativeId } : {},
+    ...issues.length > 0 ? { issues } : {},
+    ...pick(row, ["created_time"])
+  };
+}
+var ACTIVITY_COLUMNS = [
+  "event_time",
+  "event_type",
+  "actor_name",
+  "object_type",
+  "object_name",
+  "object_id",
+  "change"
+];
+function isScalar(value) {
+  return value === null || typeof value === "string" || typeof value === "number";
+}
+function activityChange(extraData) {
+  if (typeof extraData !== "string") return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(extraData);
+  } catch {
+    return void 0;
+  }
+  const data = asRecord(parsed);
+  if (!data || !("new_value" in data) || !("old_value" in data)) return void 0;
+  const { old_value: before, new_value: after } = data;
+  if (!isScalar(before) || !isScalar(after)) return void 0;
+  const show = (value) => value === null ? "(none)" : String(value);
+  return `${show(before)} \u2192 ${show(after)}`;
+}
+function compactActivity(row) {
+  const change = activityChange(row.extra_data);
+  return {
+    ...pick(row, ["event_time", "event_type", "actor_name", "object_type", "object_name", "object_id"]),
+    ...change !== void 0 ? { change } : {}
+  };
+}
+var PROJECTIONS = {
+  campaigns: { row: compactCampaign, columns: CAMPAIGN_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },
+  adsets: { row: compactAdSet, columns: ADSET_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },
+  ads: { row: compactAd, columns: AD_COLUMNS },
+  activities: { row: compactActivity, columns: ACTIVITY_COLUMNS }
+};
+function shapeMetaListRows(kind, rows, args) {
+  return shapeListRows(rows, args, PROJECTIONS[kind]);
+}
+var NOUNS = {
+  campaigns: "campaigns",
+  adsets: "ad sets",
+  ads: "ads",
+  activities: "activities"
+};
+function writeMetaListRows(kind, shaped, format, hints = []) {
+  if (format === "md" && shaped.rows.length === 0) {
+    process.stdout.write(`${hints.length > 0 ? hints.join("\n") : `No ${NOUNS[kind]} matched.`}
+`);
+    return;
+  }
+  writeAdsOutput(shaped.rows, format, shaped.fields, [...hints, ...shaped.hints ?? []]);
+}
+var META_LIST_SHAPE_ARGS = {
+  fields: {
+    type: "string",
+    description: "CSV of dotted paths to return instead of the compact row, e.g. id,name,targeting.geo_locations"
+  },
+  full: { type: "boolean", description: "Return every field Meta sent (targeting, tracking specs, raw extra_data)" },
+  output: {
+    type: "string",
+    description: "md|json|csv|jsonl \u2014 md (default) prints a table; json returns the rows in the { ok, data } envelope",
+    default: "md"
+  }
+};
+function registerMetaListSchema(kind, description, args) {
+  registerSchema({
+    command: `ads.meta.${kind}`,
+    description,
+    args: Object.fromEntries(
+      Object.entries(args).map(([name, def]) => [
+        name,
+        {
+          type: def.type,
+          description: def.description ?? "",
+          required: false,
+          ...def.default !== void 0 ? { default: def.default } : {}
+        }
+      ])
+    )
+  });
+}
+
+export {
+  shapeMetaListRows,
+  writeMetaListRows,
+  META_LIST_SHAPE_ARGS,
+  registerMetaListSchema
+};
+//# sourceMappingURL=chunk-2C7AHPM4.js.map

package/dist/chunk-2C7AHPM4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/list-rows.ts"],"sourcesContent":["import { registerSchema } from \"../../../schemas.ts\";\nimport { asRecord, type CompactProjection, type ShapedRows, shapeListRows } from \"../list-rows.ts\";\nimport { writeAdsOutput } from \"../output.ts\";\n\n/**\n * The compact row of each Meta listing. The backend asks Graph for every field a\n * write or an audit might need (targeting, tracking specs, three status fields),\n * and 100 campaigns or two days of activity passed through whole ran to 55–78 KB.\n * A compact row carries what an agent decides with; `--fields` reaches any other\n * path and `--full` returns the record Graph sent.\n *\n * `effective_status` is the one status kept: it is what Ads Manager shows, and\n * `status`/`configured_status` only restate the toggle it already folds in.\n *\n * Listings print a table by default: keyed JSON repeats every column name on\n * every row, and 100 campaigns stayed near 30 KB even compact. `--output json`\n * returns the same rows in the envelope.\n */\n\ntype MetaRow = Record<string, unknown>;\n\nexport type MetaListKind = \"campaigns\" | \"adsets\" | \"ads\" | \"activities\";\n\nfunction pick(row: MetaRow, keys: readonly string[]): MetaRow {\n  const picked: MetaRow = {};\n  for (const key of keys) {\n    if (row[key] !== undefined) picked[key] = row[key];\n  }\n  return picked;\n}\n\n/**\n * An account's campaign list is the widest listing an agent reads (100+ rows), so\n * its row is the narrowest: what a campaign is called, whether it runs and what\n * it spends. Objective, bid strategy and Special Ad Category are one `--fields`\n * away; the creation day is enough to order by, and `--fields created_time` has\n * the timestamp.\n */\nconst CAMPAIGN_COLUMNS = [\"id\", \"name\", \"effective_status\", \"daily_budget\", \"lifetime_budget\", \"created_date\"] as const;\n\n/** Why delivery stops and what Meta suggests: columns only when a row has one. */\nconst DIAGNOSTIC_COLUMNS = [\"issues\", \"suggestions\"] as const;\n\nfunction compactCampaign(row: MetaRow): MetaRow {\n  const created = row.created_time;\n  return {\n    ...pick(row, [\"id\", \"name\", \"effective_status\", \"daily_budget\", \"lifetime_budget\"]),\n    ...(typeof created === \"string\" ? { created_date: created.slice(0, 10) } : {}),\n    ...diagnostics(row),\n  };\n}\n\nconst ADSET_KEYS = [\n  \"id\",\n  \"name\",\n  \"campaign_id\",\n  \"effective_status\",\n  \"optimization_goal\",\n  \"billing_event\",\n  \"bid_strategy\",\n  \"daily_budget\",\n  \"lifetime_budget\",\n  \"destination_type\",\n  // A Dynamic Creative ad set refuses every new ad, which changes the plan before anything is staged.\n  \"is_dynamic_creative\",\n] as const;\n\nconst ADSET_COLUMNS = [...ADSET_KEYS, \"learning_stage\", \"end_time\", \"created_time\"] as const;\n\nfunction compactAdSet(row: MetaRow): MetaRow {\n  const learning = asRecord(row.learning_stage_info)?.status;\n  return {\n    ...pick(row, ADSET_KEYS),\n    ...(typeof learning === \"string\" ? { learning_stage: learning } : {}),\n    ...pick(row, [\"end_time\", \"created_time\"]),\n    ...diagnostics(row),\n  };\n}\n\nconst AD_COLUMNS = [\n  \"id\",\n  \"name\",\n  \"adset_id\",\n  \"campaign_id\",\n  \"effective_status\",\n  \"creative_id\",\n  \"issues\",\n  \"created_time\",\n] as const;\n\n/** Why an ad is WITH_ISSUES — the one reason to open `issues_info`, in its own words. */\nfunction adIssues(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const issue = asRecord(entry);\n    const text = issue?.error_summary ?? issue?.error_message;\n    return typeof text === \"string\" && text ? [text] : [];\n  });\n}\n\n/** Meta's suggestions for a campaign or ad set (`recommendations`), by their titles. */\nfunction suggestions(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const recommendation = asRecord(entry);\n    const text = recommendation?.title ?? recommendation?.message;\n    return typeof text === \"string\" && text ? [text] : [];\n  });\n}\n\n/** Why a campaign or ad set cannot deliver, and what Meta suggests — only when Meta says something. */\nfunction diagnostics(row: MetaRow): MetaRow {\n  const issues = adIssues(row.issues_info);\n  const suggested = suggestions(row.recommendations);\n  return {\n    ...(issues.length > 0 ? { issues } : {}),\n    ...(suggested.length > 0 ? { suggestions: suggested } : {}),\n  };\n}\n\nfunction compactAd(row: MetaRow): MetaRow {\n  const creativeId = asRecord(row.creative)?.id;\n  const issues = adIssues(row.issues_info);\n  return {\n    ...pick(row, [\"id\", \"name\", \"adset_id\", \"campaign_id\", \"effective_status\"]),\n    ...(creativeId !== undefined ? { creative_id: creativeId } : {}),\n    ...(issues.length > 0 ? { issues } : {}),\n    ...pick(row, [\"created_time\"]),\n  };\n}\n\nconst ACTIVITY_COLUMNS = [\n  \"event_time\",\n  \"event_type\",\n  \"actor_name\",\n  \"object_type\",\n  \"object_name\",\n  \"object_id\",\n  \"change\",\n] as const;\n\nfunction isScalar(value: unknown): value is string | number | null {\n  return value === null || typeof value === \"string\" || typeof value === \"number\";\n}\n\n/**\n * `extra_data` is a JSON string whose shape varies by event type and carries most\n * of an activity's bytes (image URLs, whole targeting specs). A status, name,\n * budget or goal change stores its before and after as two plain values — those\n * read as one line; any richer change stays behind `--fields extra_data`.\n */\nexport function activityChange(extraData: unknown): string | undefined {\n  if (typeof extraData !== \"string\") return undefined;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(extraData);\n  } catch {\n    return undefined;\n  }\n  const data = asRecord(parsed);\n  // An absent old_value is one this read did not observe, not an unset one — only `null` means \"none\".\n  if (!data || !(\"new_value\" in data) || !(\"old_value\" in data)) return undefined;\n  const { old_value: before, new_value: after } = data;\n  if (!isScalar(before) || !isScalar(after)) return undefined;\n  const show = (value: string | number | null) => (value === null ? \"(none)\" : String(value));\n  return `${show(before)} → ${show(after)}`;\n}\n\nfunction compactActivity(row: MetaRow): MetaRow {\n  const change = activityChange(row.extra_data);\n  return {\n    ...pick(row, [\"event_time\", \"event_type\", \"actor_name\", \"object_type\", \"object_name\", \"object_id\"]),\n    ...(change !== undefined ? { change } : {}),\n  };\n}\n\nconst PROJECTIONS: Record<MetaListKind, CompactProjection<MetaRow>> = {\n  campaigns: { row: compactCampaign, columns: CAMPAIGN_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },\n  adsets: { row: compactAdSet, columns: ADSET_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },\n  ads: { row: compactAd, columns: AD_COLUMNS },\n  activities: { row: compactActivity, columns: ACTIVITY_COLUMNS },\n};\n\nexport function shapeMetaListRows(kind: MetaListKind, rows: MetaRow[], args: Record<string, unknown>): ShapedRows {\n  return shapeListRows(rows, args, PROJECTIONS[kind]);\n}\n\nconst NOUNS: Record<MetaListKind, string> = {\n  campaigns: \"campaigns\",\n  adsets: \"ad sets\",\n  ads: \"ads\",\n  activities: \"activities\",\n};\n\n/**\n * A table of no rows prints nothing at all, which reads as a failed call — so an empty\n * listing says so, and says why when a status filter may be hiding rows.\n */\nexport function writeMetaListRows(kind: MetaListKind, shaped: ShapedRows, format: string, hints: string[] = []): void {\n  if (format === \"md\" && shaped.rows.length === 0) {\n    process.stdout.write(`${hints.length > 0 ? hints.join(\"\\n\") : `No ${NOUNS[kind]} matched.`}\\n`);\n    return;\n  }\n  writeAdsOutput(shaped.rows, format, shaped.fields, [...hints, ...(shaped.hints ?? [])]);\n}\n\n/** The projection flags every Meta listing shares, worded once for help and `baker schema`. */\nexport const META_LIST_SHAPE_ARGS = {\n  fields: {\n    type: \"string\",\n    description: \"CSV of dotted paths to return instead of the compact row, e.g. id,name,targeting.geo_locations\",\n  },\n  full: { type: \"boolean\", description: \"Return every field Meta sent (targeting, tracking specs, raw extra_data)\" },\n  output: {\n    type: \"string\",\n    description: \"md|json|csv|jsonl — md (default) prints a table; json returns the rows in the { ok, data } envelope\",\n    default: \"md\",\n  },\n} as const;\n\ninterface ListArgDef {\n  type: string;\n  description?: string;\n  default?: unknown;\n}\n\n/**\n * `baker schema ads.meta.<list>`, read off the same arg defs the command parses,\n * so the introspection an agent checks before a call cannot promise a flag the\n * command refuses — `--full` on `adsets` was guessed three times in one Session.\n */\nexport function registerMetaListSchema(\n  kind: MetaListKind,\n  description: string,\n  args: Record<string, ListArgDef>,\n): void {\n  registerSchema({\n    command: `ads.meta.${kind}`,\n    description,\n    args: Object.fromEntries(\n      Object.entries(args).map(([name, def]) => [\n        name,\n        {\n          type: def.type,\n          description: def.description ?? \"\",\n          required: false,\n          ...(def.default !== undefined ? { default: def.default } : {}),\n        },\n      ]),\n    ),\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-2LI6746F.js

@@ -0,0 +1,103 @@
+import {
+  SITE_COLLECTION_MODES,
+  SITE_CONSENT_MODES,
+  SITE_HOME_MODES
+} from "./chunk-66QHX566.js";
+import {
+  ApiError
+} from "./chunk-XDZVBX6L.js";
+import {
+  writeJson
+} from "./chunk-WNSE7N75.js";
+
+// src/commands/site/setArgs.ts
+var SiteArgsError = class extends Error {
+};
+function oneOf(flag, value, allowed) {
+  if (!allowed.includes(value)) {
+    throw new SiteArgsError(`--${flag} must be one of: ${allowed.join(", ")}`);
+  }
+  return value;
+}
+function onOff(flag, value) {
+  if (value === "on" || value === "true") return true;
+  if (value === "off" || value === "false") return false;
+  throw new SiteArgsError(`--${flag} must be on or off`);
+}
+function parseProfile(raw, readFile) {
+  const text = raw.startsWith("@") ? readFile(raw.slice(1)) : raw;
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    throw new SiteArgsError("--export-profile must be JSON, or @path to a JSON file");
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new SiteArgsError("--export-profile must be a JSON object");
+  }
+  return parsed;
+}
+function parseSetArgs(args, readFile) {
+  const inputs = [];
+  if (args.consent !== void 0) {
+    inputs.push({ setting: "consent", mode: oneOf("consent", args.consent, SITE_CONSENT_MODES) });
+  }
+  if (args.collection !== void 0) {
+    const mode = oneOf("collection", args.collection, SITE_COLLECTION_MODES);
+    inputs.push({
+      setting: "analyticsCollection",
+      mode,
+      ...args.payloads === void 0 ? {} : { payloads: onOff("payloads", args.payloads) }
+    });
+  } else if (args.payloads !== void 0) {
+    throw new SiteArgsError("--payloads goes with --collection, e.g. --collection full --payloads off");
+  }
+  if (args.indexing !== void 0) {
+    inputs.push({ setting: "indexing", enabled: onOff("indexing", args.indexing) });
+  }
+  if (args.home !== void 0) {
+    const slug = args.home.trim().replace(/^\/+|\/+$/g, "");
+    inputs.push(
+      slug === "none" || slug === "" ? { setting: "homePage", override: null } : {
+        setting: "homePage",
+        override: { mode: oneOf("home-mode", args["home-mode"] ?? "rewrite", SITE_HOME_MODES), slug }
+      }
+    );
+  } else if (args["home-mode"] !== void 0) {
+    throw new SiteArgsError("--home-mode goes with --home <landing slug>");
+  }
+  if (args.timezone !== void 0) {
+    inputs.push({ setting: "timezone", timezone: args.timezone });
+  }
+  if (args["export-profile"] !== void 0) {
+    inputs.push({ setting: "exportProfile", profile: parseProfile(args["export-profile"], readFile) });
+  }
+  if (inputs.length === 0) {
+    throw new SiteArgsError(
+      "Nothing to stage. Pass at least one of --consent, --collection, --indexing, --home, --timezone, --export-profile."
+    );
+  }
+  return inputs;
+}
+
+// src/commands/site/shared.ts
+function failSite(err) {
+  if (err instanceof SiteArgsError) {
+    writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: err.message } });
+  } else if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+  } else {
+    writeJson({
+      ok: false,
+      error: { code: "INTERNAL_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+    });
+  }
+  process.exit(1);
+}
+
+export {
+  SiteArgsError,
+  parseSetArgs,
+  failSite
+};
+//# sourceMappingURL=chunk-2LI6746F.js.map

package/dist/chunk-2PWNIEW4.js

@@ -0,0 +1,197 @@
+import {
+  mediaTagsCreateRequestSchema,
+  mediaTagsDeleteRequestSchema,
+  mediaTagsUpdateRequestSchema
+} from "./chunk-66QHX566.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-XDZVBX6L.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WNSE7N75.js";
+
+// src/lib/tags-command.ts
+import { defineCommand } from "citty";
+var OUTPUT_ARG = {
+  output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
+};
+var SHARED_POOL_HINT = "Custom tags are one pool shared by images, videos and testimonials \u2014 this change shows up in all three. Already applied: publishing or discarding this chat does not undo it.";
+function fail(err) {
+  const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
+  const message = err instanceof ApiError ? err.message : "Unexpected error";
+  writeJson({ ok: false, error: { code, message } });
+  process.exit(1);
+}
+function failInvalid(issue) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: issue?.message ?? "Invalid request" } });
+  process.exit(1);
+}
+function makeTagsCommand(command, label, endpoint) {
+  registerSchema({
+    command: `${command}.tags.list`,
+    description: `List the available ${label} tag taxonomy (built-in defaults + this company's custom tags).`,
+    args: OUTPUT_ARG
+  });
+  const listCommand = defineCommand({
+    meta: {
+      name: "list",
+      description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
+    },
+    args: OUTPUT_ARG,
+    run: async ({ args }) => {
+      try {
+        const { markdown } = await apiGet(endpoint);
+        if (args.output === "json") {
+          writeJson({ ok: true, data: { markdown } });
+          return;
+        }
+        process.stdout.write(`${markdown.trimEnd()}
+`);
+      } catch (err) {
+        const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
+        const message = err instanceof ApiError ? err.message : "Unexpected error";
+        if (args.output === "json") {
+          writeJson({ ok: false, error: { code, message } });
+        } else {
+          process.stderr.write(`Error: ${message}
+`);
+        }
+        process.exit(1);
+      }
+    }
+  });
+  const createArgs = {
+    name: { type: "positional", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
+    description: {
+      type: "string",
+      description: "What the tag means, so it gets applied consistently",
+      required: false
+    }
+  };
+  registerSchema({
+    command: `${command}.tags.create`,
+    description: "Create a custom media tag in the company's shared pool (images, videos and testimonials). Applies immediately. Use when no built-in or custom tag fits.",
+    args: {
+      name: { type: "string", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
+      description: createArgs.description
+    }
+  });
+  const createCommand = defineCommand({
+    meta: {
+      name: "create",
+      description: `Create a custom tag (shared by images, videos and testimonials). Applies immediately.
+
+Example: baker ${command} tags create "summer sale" --description "Assets for the summer sale campaign"`
+    },
+    args: createArgs,
+    run: async ({ args }) => {
+      const parsed = mediaTagsCreateRequestSchema.safeParse({
+        name: String(args.name ?? ""),
+        ...args.description ? { description: String(args.description) } : {}
+      });
+      if (!parsed.success) failInvalid(parsed.error.issues[0]);
+      try {
+        const data = await apiPost("/api/media-tags/create", parsed.data);
+        writeJson({
+          ok: true,
+          data,
+          hints: [
+            SHARED_POOL_HINT,
+            `Use it as \`--tags ${data.name}\`.`,
+            ...data.description ? [] : ["MISSING --description: add one with `tags update` so the tag is applied consistently."]
+          ]
+        });
+      } catch (err) {
+        fail(err);
+      }
+    }
+  });
+  registerSchema({
+    command: `${command}.tags.update`,
+    description: "Change what a custom tag means (its description). Built-in tags cannot be changed. Applies immediately.",
+    args: {
+      slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true },
+      description: { type: "string", description: "New description", required: true }
+    }
+  });
+  const updateCommand = defineCommand({
+    meta: {
+      name: "update",
+      description: `Change a custom tag's description. Built-in tags cannot be changed. Applies immediately.
+
+Example: baker ${command} tags update summer-sale --description "Assets for the 2026 summer sale"`
+    },
+    args: {
+      slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true },
+      description: { type: "string", description: "New description", required: true }
+    },
+    run: async ({ args }) => {
+      const parsed = mediaTagsUpdateRequestSchema.safeParse({
+        slug: String(args.slug ?? ""),
+        description: String(args.description ?? "")
+      });
+      if (!parsed.success) failInvalid(parsed.error.issues[0]);
+      try {
+        const data = await apiPost("/api/media-tags/update", parsed.data);
+        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
+      } catch (err) {
+        fail(err);
+      }
+    }
+  });
+  registerSchema({
+    command: `${command}.tags.delete`,
+    description: "Delete a custom tag from the company's shared pool. Built-in tags cannot be deleted. Applies immediately. Confirm with the user first.",
+    args: { slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true } }
+  });
+  const deleteCommand = defineCommand({
+    meta: {
+      name: "delete",
+      description: `Delete a custom tag (shared by images, videos and testimonials). Built-in tags cannot be deleted. Applies immediately \u2014 confirm with the user first.
+
+Example: baker ${command} tags delete summer-sale`
+    },
+    args: { slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true } },
+    run: async ({ args }) => {
+      const parsed = mediaTagsDeleteRequestSchema.safeParse({ slug: String(args.slug ?? "") });
+      if (!parsed.success) failInvalid(parsed.error.issues[0]);
+      try {
+        const data = await apiPost("/api/media-tags/delete", parsed.data);
+        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
+      } catch (err) {
+        fail(err);
+      }
+    }
+  });
+  return defineCommand({
+    meta: {
+      name: "tags",
+      description: `The ${label} tag taxonomy: built-in defaults plus the company's custom tags (one pool shared by images, videos and testimonials). Subcommands: list (default), create, update, delete.
+
+Examples:
+  baker ${command} tags                                   # list available tags
+  baker ${command} tags create "summer sale" --description "\u2026"
+  baker ${command} tags update summer-sale --description "\u2026"
+  baker ${command} tags delete summer-sale`
+    },
+    // Declared on the parent too: `default: "list"` dispatches the bare `tags --output json`
+    // form, and citty reads an undeclared flag's value as a subcommand name.
+    args: OUTPUT_ARG,
+    subCommands: {
+      list: listCommand,
+      create: createCommand,
+      update: updateCommand,
+      delete: deleteCommand
+    },
+    // `default`, never `run`: citty falls through to the parent's `run` after a subcommand.
+    default: "list"
+  });
+}
+
+export {
+  makeTagsCommand
+};
+//# sourceMappingURL=chunk-2PWNIEW4.js.map