@koda-sl/baker-cli 0.193.0 → 0.194.0-dev.5dba041c4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -777,6 +777,12 @@ baker ads meta ads --account-id act_123 --all-statuses # widen to
777
777
  baker ads meta creatives --creative-id 9988
778
778
  baker ads meta preview --creative-id 9988 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html
779
779
 
780
+ # "Why does it show as a still image in one placement?"
781
+ baker ads meta insights --object 9988 --level ad --intent video \
782
+ --breakdowns publisher_platform,platform_position --date-preset last_30d # one ad only: hints flag placements that never played
783
+ baker ads meta preview --creative-id 9988 --placement facebook_reels_overlay --platform facebook
784
+ baker ads meta preview --list-formats # ad_format values + placement mappings
785
+
780
786
  # "What audience is this targeting?"
781
787
  baker ads meta audiences --account-id act_123
782
788
 
@@ -847,10 +853,14 @@ creatives # list per account, or fetch single via --creative-id
847
853
  audiences # custom audiences (incl. lookalikes)
848
854
  pixels # list, or --stats for one --pixel-id (see "Restricted pixel fields")
849
855
  activities # account audit log, ~90d retention
850
- insights # see "Smart defaults" above
851
- preview # iframe HTML for a creative or ad in a given ad_format
856
+ insights # see "Smart defaults" above; a single-ad placement breakdown returns hints
857
+ # naming placements that delivered impressions but never played the video
858
+ preview # iframe HTML for a creative or ad in a given ad_format, or in the
859
+ # placement an insights breakdown reported (--placement, --list-formats)
852
860
  ```
853
861
 
862
+ Placement diagnostics deliberately stop at evidence. `insights` names a suspect placement with its share of delivery, `preview` shows what Meta renders there, and neither asserts *why* — Meta documents an eligibility error for a video creative in a video-incompatible placement, not a silent fallback to the cover frame. Ad-set writes that pin placements warn about the learning-phase reset, and a placement set missing the `feed` Meta requires alongside `marketplace`/`search`/`profile_feed`/`notification` is rejected at stage time.
863
+
854
864
  The HTTP backend exposes more endpoints (catalogs, ad-studies, ad-images, labels, high-demand-periods, raw currency lookup). They're intentionally not surfaced as CLI commands because AI agents rarely need them. Hit them via curl against `/api/ads/meta/*` if needed.
855
865
 
856
866
  #### Auth + caching
@@ -7,9 +7,9 @@ import {
7
7
  __toESM
8
8
  } from "./chunk-YL3HDEIJ.js";
9
9
 
10
- // ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
10
+ // ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/810146e81bae4e3a061fe487864f2fde80c4b03b886877dc0f1fffbc6480b67e/node_modules/safe-stable-stringify/index.js
11
11
  var require_safe_stable_stringify = __commonJS({
12
- "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js"(exports, module) {
12
+ "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/810146e81bae4e3a061fe487864f2fde80c4b03b886877dc0f1fffbc6480b67e/node_modules/safe-stable-stringify/index.js"(exports, module) {
13
13
  "use strict";
14
14
  var { hasOwnProperty } = Object.prototype;
15
15
  var stringify = configure2();
@@ -1083,7 +1083,7 @@ function resolveAdaptFormats(params) {
1083
1083
  return params.formats ?? [];
1084
1084
  }
1085
1085
 
1086
- // ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
1086
+ // ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/810146e81bae4e3a061fe487864f2fde80c4b03b886877dc0f1fffbc6480b67e/node_modules/safe-stable-stringify/esm/wrapper.js
1087
1087
  var import__ = __toESM(require_safe_stable_stringify(), 1);
1088
1088
  var configure = import__.default.configure;
1089
1089
  var wrapper_default = import__.default;
@@ -8407,4 +8407,4 @@ export {
8407
8407
  defaultRegistry,
8408
8408
  createEngineFromEnv
8409
8409
  };
8410
- //# sourceMappingURL=chunk-O5GXFPWC.js.map
8410
+ //# sourceMappingURL=chunk-5YX3QOT3.js.map