@koda-sl/baker-cli 0.546.0-dev.e8b0ca6de → 0.547.0

package/dist/update-O76YSKXB.js

@@ -0,0 +1,192 @@
+import {
+  buildProfilePatch,
+  hasProfileEdit,
+  mergeProfile
+} from "./chunk-IJMWEO4P.js";
+import {
+  failAvatarApi,
+  failValidation,
+  updateHints
+} from "./chunk-BPFNGLDE.js";
+import {
+  readAvatars,
+  writeAvatars
+} from "./chunk-C4EE6LIF.js";
+import {
+  AVATAR_HANDLE_PATTERN,
+  AVATAR_RELATIONS
+} from "./chunk-VR2AF7I7.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-MSMTG6OC.js";
+import "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/update.ts
+import { defineCommand } from "citty";
+
+// src/commands/avatars/relation.ts
+function relationPatch(args) {
+  const relation = typeof args.relation === "string" ? args.relation.trim().toLowerCase() : "";
+  const testimonial = typeof args.testimonial === "string" ? args.testimonial : "";
+  const ids = testimonial.split(",").map((id) => id.trim()).filter(Boolean);
+  const known = AVATAR_RELATIONS.find((r) => r === relation);
+  if (relation && !known) {
+    return { ok: false, message: `--relation "${relation}" is not one of ${AVATAR_RELATIONS.join(", ")}.` };
+  }
+  return {
+    ok: true,
+    patch: { ...known ? { relation: known } : {}, ...ids.length > 0 ? { testimonialIds: ids } : {} }
+  };
+}
+
+// src/commands/avatars/update.ts
+function readUpdateArgs(args) {
+  const handle = (args.handle || args["avatar-handle"])?.trim();
+  if (!handle) {
+    failValidation('An avatar handle is required, e.g. `baker avatars update marta --persona "\u2026"`.');
+  }
+  const name = args.name?.trim();
+  const newHandle = args["new-handle"]?.trim().toLowerCase();
+  const regenerateSheet = Boolean(args["regenerate-sheet"]);
+  const patch = buildProfilePatch(args);
+  const who = relationPatch(args);
+  if (!who.ok) failValidation(who.message);
+  if (patch.subjectDescription === "") {
+    failValidation(
+      "--subject cannot be emptied: it is what the identity sheet was built from. Replace it with a new description of the same length or better, and pass --regenerate-sheet."
+    );
+  }
+  if (newHandle && !AVATAR_HANDLE_PATTERN.test(newHandle)) {
+    failValidation(
+      `--new-handle "${newHandle}" is not usable. Use lowercase letters, numbers and dashes, starting with a letter.`
+    );
+  }
+  if (!name && !newHandle && !hasProfileEdit(patch) && !regenerateSheet && Object.keys(who.patch).length === 0) {
+    failValidation(
+      "Nothing to change. Pass at least one of --name, --new-handle, --subject, --persona, --speech, --motion, --wardrobe, --setting, --accent, --guardrails, --relation, --testimonial, --regenerate-sheet."
+    );
+  }
+  return { handle, name, newHandle, regenerateSheet, patch, who: who.patch };
+}
+registerSchema({
+  command: "avatars.update",
+  description: 'Edit an avatar: rename it, change its handle, rewrite any part of its written profile, set the accent it speaks with, or rebuild its identity sheet. Profile flags are merged over what is stored, so `--persona "\u2026"` alone leaves the subject description intact. When you change --subject, pass --regenerate-sheet in the same call \u2014 otherwise the sheet still shows the person you described before, the words and the face stop matching, and every render drifts. Rebuilding is a ~30s billed render and puts the avatar back to `generating`.',
+  args: {
+    handle: { type: "positional", description: "Handle of the avatar to edit", required: false },
+    "avatar-handle": { type: "string", description: "Handle (alternative to positional)", required: false },
+    name: { type: "string", description: "New display name", required: false },
+    "new-handle": { type: "string", description: "New mention handle (lowercase, dashes)", required: false },
+    subject: {
+      type: "string",
+      description: "Rewrite the identity description. Pass --regenerate-sheet with it, always.",
+      required: false
+    },
+    persona: { type: "string", description: "Who they are on camera", required: false },
+    speech: { type: "string", description: "How they speak", required: false },
+    motion: { type: "string", description: "Body language in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit", required: false },
+    setting: { type: "string", description: "Default surroundings", required: false },
+    guardrails: {
+      type: "string",
+      description: "Comma-separated things they must never do (replaces the stored list; empty string clears it)",
+      required: false
+    },
+    accent: {
+      type: "string",
+      description: "Where their voice is FROM, as a place: 'Spanish from Spain, Madrid accent', 'Mexican Spanish'. THE lever for how they sound \u2014 an avatar has no pinned voice (ADR 0005), so the region directed in the prompt is the only thing steering pronunciation. An adjective like 'clear Spanish accent' is read as NO accent and the clip comes out sounding like nowhere.",
+      required: false
+    },
+    relation: {
+      type: "string",
+      description: "Who this person is to the company: team | founder | customer | partner | creator | role. A customer, partner or creator face appears only in an ad quoting their own published words; only team, founder and role faces are cast freely.",
+      required: false
+    },
+    testimonial: {
+      type: "string",
+      description: "Comma-separated testimonial ids this person gave (their quotes may carry their face in an ad)",
+      required: false
+    },
+    "regenerate-sheet": {
+      type: "boolean",
+      description: "Rebuild the identity sheet (~30s, billed). Required whenever --subject changed.",
+      required: false,
+      default: false
+    }
+  }
+});
+var updateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: 'Edit an avatar; profile flags merge over what is stored. Example: baker avatars update marta --subject "woman in her early 50s, silver bob" --regenerate-sheet'
+  },
+  args: {
+    handle: { type: "positional", description: "Handle of the avatar to edit", required: false },
+    "avatar-handle": { type: "string", description: "Handle (alternative to positional)", required: false },
+    name: { type: "string", description: "New display name", required: false },
+    "new-handle": { type: "string", description: "New mention handle", required: false },
+    subject: { type: "string", description: "Rewrite the identity description", required: false },
+    persona: { type: "string", description: "Who they are on camera", required: false },
+    speech: { type: "string", description: "How they speak", required: false },
+    motion: { type: "string", description: "Body language in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit", required: false },
+    setting: { type: "string", description: "Default surroundings", required: false },
+    guardrails: { type: "string", description: "Comma-separated rules (empty string clears)", required: false },
+    accent: { type: "string", description: "Where their voice is FROM, as a place", required: false },
+    relation: { type: "string", description: "team | founder | customer | partner | creator | role", required: false },
+    testimonial: { type: "string", description: "Comma-separated testimonial ids this person gave", required: false },
+    "regenerate-sheet": {
+      type: "boolean",
+      description: "Rebuild the identity sheet (~30s, billed)",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    const { handle, name, newHandle, regenerateSheet, patch, who } = readUpdateArgs(args);
+    try {
+      let profile;
+      let subjectChanged = false;
+      if (hasProfileEdit(patch)) {
+        const current = await readAvatars("/api/avatars/get", { handle, full: "1" });
+        profile = mergeProfile(current.profile, patch);
+        subjectChanged = profile.subjectDescription !== current.profile.subjectDescription;
+      }
+      const body = {
+        handle,
+        ...name ? { name } : {},
+        ...newHandle ? { newHandle } : {},
+        ...profile ? { profile } : {},
+        ...regenerateSheet ? { regenerateSheet: true } : {},
+        ...who
+      };
+      const data = await writeAvatars("/api/avatars/update", body);
+      writeJson({
+        ok: true,
+        data,
+        hints: updateHints({
+          avatar: data.avatar,
+          subjectChanged,
+          regeneratedSheet: regenerateSheet,
+          previousHandle: handle
+        })
+      });
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+export {
+  updateCommand
+};
+//# sourceMappingURL=update-O76YSKXB.js.map

package/dist/update-YS4QI2KP.js

@@ -0,0 +1,66 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-3I66ZQTI.js";
+import "./chunk-VR2AF7I7.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-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/tags/update.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.tags.update",
+  description: "Change what a company custom action tag means (its description). Applies at once, like `tags create`. The slug itself cannot be renamed \u2014 every Task carrying it stores it; to rename, create the new tag, retag the Tasks, then delete the old one. Built-in default tags cannot be changed.",
+  args: {
+    slug: { type: "string", description: "Custom tag slug to change", required: true },
+    description: { type: "string", description: "What this tag means", required: true }
+  }
+});
+var tagsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: 'Change what a custom action tag means. Example: baker actions tags update --slug pmax --description "Performance Max campaigns"'
+  },
+  args: {
+    slug: { type: "string", description: "Custom tag slug", required: false },
+    description: { type: "string", description: "What this tag means", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const slug = args.slug?.trim();
+      if (!slug) {
+        failValidation("--slug is required.");
+      }
+      const description = args.description;
+      if (description === void 0) {
+        failValidation("--description is required: what this tag means.");
+      }
+      const response = await apiPost("/api/actions/tags/update", {
+        name: slug,
+        description
+      });
+      writeOk(response.data);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  tagsUpdateCommand
+};
+//# sourceMappingURL=update-YS4QI2KP.js.map

package/dist/upload-XVV3HQ5W.js

@@ -0,0 +1,130 @@
+import {
+  runVideoIngest
+} from "./chunk-J4JY435Z.js";
+import "./chunk-FKOECEVC.js";
+import "./chunk-JELKYZ4L.js";
+import {
+  detectVideoContentType,
+  uploadLocalVideo
+} from "./chunk-WUGTZHFI.js";
+import "./chunk-XBR7TSZN.js";
+import "./chunk-VR2AF7I7.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-MSMTG6OC.js";
+import {
+  ApiError
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/upload.ts
+import { stat } from "fs/promises";
+import { basename } from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "videos.upload",
+  description: "Upload a video to Baker \u2014 a local file (via Mux direct upload) or a remote http(s) URL.",
+  args: {
+    file: { type: "string", description: "Local video file path, or a remote http(s) URL", required: true },
+    "content-type": {
+      type: "string",
+      description: "MIME type (auto-detected from extension if omitted)",
+      required: false
+    },
+    context: {
+      type: "string",
+      description: "What this clip is and what it is for. Feeds the analysis, so it is the single highest-leverage flag here. Example: --context 'Customer testimonial from Maria, shot on her phone for the Q3 retargeting push'",
+      required: false
+    },
+    "dry-run": {
+      type: "boolean",
+      description: "Preview the operation without executing",
+      required: false,
+      default: false
+    }
+  }
+});
+function isRemoteUrl(value) {
+  return /^https?:\/\//i.test(value);
+}
+var uploadCommand = defineCommand({
+  meta: {
+    name: "upload",
+    description: "Upload a video to Baker \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: auto-detects content type and uploads via Mux direct upload.\nRemote: hands off to `videos ingest` (direct fetch, or download-then-upload for a YouTube/TikTok/Vimeo page).\n\nExamples:\n  baker videos upload ./demo.mp4\n  baker videos upload https://www.youtube.com/watch?v=abc123"
+  },
+  args: {
+    file: { type: "positional", description: "Local video file path or remote http(s) URL", required: false },
+    "content-type": { type: "string", description: "MIME type (local only \u2014 auto-detected)", required: false },
+    context: {
+      type: "string",
+      description: "What this clip is and what it is for \u2014 who is on camera, which campaign, how it was shot. Start here: the analysis reads it, so it is what makes the clip findable later.",
+      required: false
+    },
+    source: { type: "string", description: "Provenance (URL mode only): url | youtube", required: false },
+    "external-id": { type: "string", description: "Provider asset id (URL mode only)", required: false },
+    "external-url": { type: "string", description: "Canonical page URL (URL mode only)", required: false },
+    "dry-run": { type: "boolean", description: "Preview without executing", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const filePath = args.file;
+      if (!filePath) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "File path or URL is required" } });
+        process.exit(1);
+      }
+      if (isRemoteUrl(filePath)) {
+        await runVideoIngest({
+          urls: [filePath],
+          source: args.source,
+          externalId: args["external-id"],
+          externalUrl: args["external-url"],
+          context: args.context,
+          dryRun: args["dry-run"] === true
+        });
+        return;
+      }
+      const contentType = args["content-type"] || detectVideoContentType(filePath);
+      const descriptionContext = args.context;
+      if (args["dry-run"]) {
+        const fileStats = await stat(filePath);
+        const originalFilename = basename(filePath);
+        writeJson({
+          ok: true,
+          dryRun: true,
+          operation: "videos.upload",
+          params: { file: filePath, contentType, sizeBytes: fileStats.size, originalFilename, descriptionContext }
+        });
+        return;
+      }
+      const { videoId } = await uploadLocalVideo({ file: filePath, contentType, descriptionContext });
+      writeJson({
+        ok: true,
+        data: { videoId },
+        hints: descriptionContext ? void 0 : [
+          "No --context given. Analysis runs on the frames and audio alone, so who is on camera and which campaign this belongs to will be guessed. Pass --context next time."
+        ]
+      });
+    } 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 {
+  uploadCommand
+};
+//# sourceMappingURL=upload-XVV3HQ5W.js.map

package/dist/url-options-YZ6UG3NY.js

@@ -0,0 +1,131 @@
+import {
+  mappingCommandFor,
+  proposeMappingFromTemplate
+} from "./chunk-PILLZPNC.js";
+import "./chunk-NKQWDEB7.js";
+import {
+  parseApiError
+} from "./chunk-JLLGXYOZ.js";
+import {
+  urlOptionsHints
+} from "./chunk-SNWFM2DB.js";
+import {
+  getManagerIdForCustomer,
+  resolveCustomerId,
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-MGWAZXY6.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/url-options.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/google/mapping-hints.ts
+function observedTemplates(report) {
+  const values = [
+    report.account.final_url_suffix,
+    report.account.tracking_url_template,
+    ...[...report.campaigns.overrides, ...report.ad_groups.overrides, ...report.ads.overrides].flatMap((entity) => [
+      entity.final_url_suffix,
+      entity.tracking_url_template
+    ])
+  ];
+  return values.flatMap((value) => value.state === "set" ? [value.value] : []);
+}
+function mappingHints(report) {
+  const proposed = {};
+  const unexplained = /* @__PURE__ */ new Map();
+  for (const template of observedTemplates(report)) {
+    const proposal = proposeMappingFromTemplate(template, "google");
+    Object.assign(proposed, proposal.proposed);
+    for (const param of proposal.unexplained) unexplained.set(param.name, param.value);
+  }
+  const hints = [];
+  const command = mappingCommandFor("google", proposed);
+  if (command !== "") {
+    hints.push(
+      `These URLs carry campaign parameters Baker does not read yet: ${Object.keys(proposed).join(", ")}. Until it is told, their values are not stored at all \u2014 only that the name appeared \u2014 so every keyword and campaign breakdown for this account will come back empty rather than wrong. The placeholders say what each one is, so run: ${command}`
+    );
+  }
+  if (unexplained.size > 0) {
+    const named = [...unexplained].map(([name, value]) => `${name}=${value}`).join(", ");
+    hints.push(
+      `These carry something no placeholder explains: ${named}. Do not guess \u2014 if it is a dimension, map it by name with \`baker analytics map --platform google --set <name>=<role>\`; if it is a session token or a cache buster, \`=ignore\` stops it being listed as something to deal with.`
+    );
+  }
+  return hints;
+}
+
+// src/commands/ads/google/url-options.ts
+registerSchema({
+  command: "ads.google.url-options",
+  description: "Report the Google Ads URL/tracking options in force at every level: the account-level final URL suffix and tracking template, plus every campaign, ad group and ad that overrides them. Every value is tagged set | not_set | not_read, so an unread level is never mistaken for an unset one. Read this before answering any UTM / tracking-parameter question. Compact by default: only overriding campaigns are listed; --full lists every campaign read.",
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "List every campaign read, including those with no override of their own.",
+      required: false
+    },
+    "no-cache": { type: "boolean", description: "Skip the read cache", required: false }
+  }
+});
+var urlOptionsCommand = defineCommand({
+  meta: {
+    name: "url-options",
+    description: `Show the URL/tracking options in force \u2014 account-level final URL suffix and tracking template, plus the campaigns, ad groups and ads that override them (the most specific level wins).
+
+Start here for any "add utm_\u2026 / tracking parameter / agency tag" question: it tells you which level already carries one.
+Each value is tagged: set | not_set (Google carries no value there) | not_read (never observed \u2014 NOT a finding).
+Judgment on which level to use and what to put in it: /google-ads-playbook \u2192 18-naming-utm.md.
+
+Examples:
+  baker ads google url-options --customer-id 1234567890
+  baker ads google url-options --customer-id 1234567890 --full`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID (10 digits)", required: false },
+    full: { type: "boolean", description: "List every campaign read, not only the overriding ones", required: false },
+    "no-cache": { type: "boolean", description: "Skip the read cache", required: false }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    try {
+      const managerId = getManagerIdForCustomer(customerId);
+      const data = await apiPost("/api/ads/google/url-options", {
+        customerId,
+        ...managerId ? { managerId } : {},
+        ...args.full ? { full: true } : {},
+        ...args["no-cache"] ? { skipCache: true } : {}
+      });
+      const hints = [...urlOptionsHints(data), ...mappingHints(data)];
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseApiError(err.message, "", customerId, err.code));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  urlOptionsCommand
+};
+//# sourceMappingURL=url-options-YZ6UG3NY.js.map

package/dist/url-params-XL5URMTG.js

@@ -0,0 +1,101 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-IGIACW2B.js";
+import {
+  writeAdsJson
+} from "./chunk-MGWAZXY6.js";
+import {
+  LINKEDIN_TRACKING_PARAMS_AD_SET_MAX
+} from "./chunk-VR2AF7I7.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-MSMTG6OC.js";
+import {
+  apiGet
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/url-params.ts
+import { defineCommand } from "citty";
+var urlParamsCommand = defineCommand({
+  meta: {
+    name: "url-params",
+    description: `Read the URL tracking parameters in effect \u2014 the ad account's, optionally every ad set's, and the keys set at BOTH (which LinkedIn appends twice).
+
+Start here before setting UTMs on an ad set: whatever the account already carries is appended on top of it.
+
+Examples:
+  baker ads linkedin url-params                                  \u2014 the ad account's parameters
+  baker ads linkedin url-params --ad-sets                        \u2014 plus every ad set's, and the collisions
+  baker ads linkedin url-params --campaign-ids 123456,789012     \u2014 plus just those ad sets'
+  baker ads linkedin url-params --ad-sets --collisions-only      \u2014 just what would land twice`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "ad-sets": {
+      type: "boolean",
+      description: `Also read every ad set's parameters (one call each, first ${LINKEDIN_TRACKING_PARAMS_AD_SET_MAX})`
+    },
+    "campaign-ids": { type: "string", description: "Comma-separated ad set ids to read instead of all of them" },
+    "collisions-only": { type: "boolean", description: "Report only the keys set at more than one level" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["campaign-ids"]) params["campaign-ids"] = String(args["campaign-ids"]);
+      if (args["ad-sets"]) params["all-ad-sets"] = "true";
+      const data = await apiGet("/api/ads/linkedin/url-params", params);
+      const examinedAdSets = Boolean(args["ad-sets"] || args["campaign-ids"]);
+      const notes = hints(data, examinedAdSets);
+      writeAdsJson({
+        ok: true,
+        data: args["collisions-only"] ? { collisions: data.collisions, adSetCoverage: data.adSetCoverage } : data,
+        ...notes.length > 0 ? { hints: notes } : {}
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+function hints(data, examinedAdSets) {
+  const out = [];
+  if (data.unreadable.length > 0) {
+    out.push(
+      `could NOT read ${data.unreadable.map((entry) => entry.level === "account" ? "the ad account" : `ad set ${entry.id}`).join(", ")} \u2014 treat that as unknown, not as empty. Do not stage url-params against it: either it does not exist, or it holds parameters this write would replace unseen. First reason: ${data.unreadable[0]?.reason ?? "unknown"}`
+    );
+  }
+  if (data.collisions.length > 0) {
+    out.push(
+      `${data.collisions.map((c) => c.key).join(", ")} set at BOTH the account and an ad set \u2014 LinkedIn appends both, so each lands twice in the served URL. Clear it at one level with \`account url-params\` or \`campaigns url-params --clear\`.`
+    );
+  }
+  if (data.adSetCoverage?.capped) {
+    out.push(
+      `only ${data.adSetCoverage.examined} of ${data.adSetCoverage.total} ad sets were read \u2014 the collisions above cover those, not the rest. Narrow with --campaign-ids to check the others.`
+    );
+  }
+  if (!examinedAdSets) {
+    out.push("only the ad account was read \u2014 pass --ad-sets to find keys an ad set sets on top of these");
+  }
+  const allAnswered = data.unreadable.length === 0;
+  const nothingSet = data.account.state === "not_set" && data.adSets.every((adSet) => adSet.state === "not_set");
+  if (allAnswered && nothingSet) {
+    out.push("nothing is tagged \u2014 set the constants once with `baker ads linkedin account url-params`");
+  }
+  return out;
+}
+export {
+  hints,
+  urlParamsCommand
+};
+//# sourceMappingURL=url-params-XL5URMTG.js.map