@koda-sl/baker-cli 0.365.0-dev.846b2e487 → 0.365.0

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
@@ -110,21 +110,6 @@ question — and nothing in the output said so. Both spellings of an option work
110
110
  that lists every option: `baker schema <command>` (`check_schema`) when the command
111
111
  registers a schema, `baker <command> --help` (`check_help`) when it does not.
112
112
 
113
- ### Narrowing a result: `--fields`
114
-
115
- `--fields a,b,c` works on every command that prints the JSON envelope. It keeps only
116
- those keys of each record in `data` — the rows when `data` is a list or wraps one
117
- (`baker chats list --fields id,title`), `data` itself when it is a single record
118
- (`baker experiment plan ... --fields traffic,warning`). `meta`, `hints` and warnings are
119
- kept, and a name no record carries is reported in `hints` alongside the keys that do
120
- exist. Commands that declare `--fields` themselves keep their own meaning
121
- (`ads meta insights` chooses which metrics to request; `ads linkedin creatives` takes dotted
122
- paths; `actions draft` picks the columns of `--output md|files` and leaves its JSON
123
- whole). A command whose default output is text needs `--output json` for there to be an
124
- envelope to narrow; without it a note on stderr says the flag changed nothing. A success
125
- that prints its result beside `ok` rather than under `data` (`canvas validate`,
126
- `canvas critique`) comes back whole, with a hint saying `--fields` was not applied.
127
-
128
113
  ### Fresh reads: `--no-cache`
129
114
 
130
115
  Every command that caches takes `--no-cache`, and it skips **both** cache layers — the
@@ -938,7 +923,7 @@ baker ads meta custom-conversions --account-id act_123 --full # raw rule JSON,
938
923
 
939
924
  Meta writes mirror the Google/LinkedIn model: they **never hit the Graph API when you run them**. Each op is validated at stage time (field shapes, budget rules, page/Instagram identity ownership, CBO/ABO exclusivity, status-transition legality), shows in the dashboard chat as a pending Meta change, and applies only when the chat is published. Meta has no atomic batch mutate, so ops apply **sequentially** on publish — one failure skips its dependents but the publish completes.
940
925
 
941
- **That publish reaches the real ad account for every company** — Meta writes are generally available, with no per-company flag and no simulated mode to turn on. Discarding the chat before it completes is what undoes a staged change.
926
+ **That publish reaches the real ad account for every company** — Meta writes are generally available, with no per-company flag. Discarding the chat before it completes is what undoes a staged change.
942
927
 
943
928
  Chain a full ad from scratch with `meta_temp_*` refs (each create returns one):
944
929
 
@@ -978,7 +963,7 @@ Status changes are `pause|resume|archive` subcommands on `campaigns`/`adsets`/`a
978
963
  - Identity columns (`campaign_name`, `ad_name`, etc.) appended automatically per `--level` so rows are self-describing.
979
964
  - Auto-async when the query is heavy (level=ad with breakdowns over an account, >2 breakdowns, >90-day range). Pass `--async` to force it or `--no-async` to refuse fallback.
980
965
 
981
- **Listings (`campaigns`/`adsets`/`ads`)** default to `effective_status=ACTIVE` — pass `--all-statuses` to widen, or `--effective-status ACTIVE,PAUSED` for a custom set.
966
+ **Listings (`campaigns`/`adsets`/`ads`)** default to `effective_status=ACTIVE` — pass `--all-statuses` to widen, or `--effective-status ACTIVE,PAUSED` for a custom set. An empty filtered list carries a `hints` entry naming the filter and `--all-statuses` (on **stderr** for `--output csv|jsonl|md`), so "nothing active" is never read as "nothing there".
982
967
 
983
968
  **Pagination** is auto-drained (no manual cursor handling).
984
969
 
@@ -1155,7 +1140,7 @@ draft [list|remove <ref>|clear|amend <ref>|show <ref>] # review/undo/amend sta
1155
1140
 
1156
1141
  Write commands never call the LinkedIn API at stage time. Each stages an op on the current chat's draft, fully validated at staging (field limits, enums, budget minimums, URN shapes, parent existence, Baker media readiness, status-transition legality). Validation errors are structured per-field; non-blocking warnings (Maximum Delivery when no `--bid`, budget below playbook floor, audience under 300 rows, >4 lead-form questions, audience expansion/LAN on) come back in the stage envelope. Ops apply when the chat is published.
1157
1142
 
1158
- **That publish reaches the real ad account for every company** — LinkedIn writes are generally available, with no per-company flag and no simulated mode to turn on. Discarding the chat before it completes is what undoes a staged change.
1143
+ **That publish reaches the real ad account for every company** — LinkedIn writes are generally available, with no per-company flag. Discarding the chat before it completes is what undoes a staged change.
1159
1144
 
1160
1145
  ```bash
1161
1146
  # Chain creates via li_temp_* refs — group → campaign → creative in one chat
@@ -1475,7 +1460,7 @@ baker experiment fold # make the page
1475
1460
 
1476
1461
  GA4 commands for multi-channel audits **and** for configuring what the property measures. Playbook-aligned report presets, property health audits, free-form Data API queries, and staged Admin API writes.
1477
1462
 
1478
- Reads (`properties`, `config`, `audit`, `query`) happen immediately. Writes (`key-event`, `custom-dimension`, `custom-metric`, `custom-event`, `data-retention`, `audience`, `property`, `ads-link`, `enhanced-measurement`) are **staged** onto the chat, reviewed in the dashboard's Analytics tab, and applied when the chat completes — at which point they take effect on the property immediately. There is no simulated mode and no undo.
1463
+ Reads (`properties`, `config`, `audit`, `query`) happen immediately. Writes (`key-event`, `custom-dimension`, `custom-metric`, `custom-event`, `data-retention`, `audience`, `property`, `ads-link`, `enhanced-measurement`) are **staged** onto the chat, reviewed in the dashboard's Analytics tab, and applied when the chat completes — at which point they take effect on the real property immediately, with no undo.
1479
1464
 
1480
1465
  A Google Analytics connection made before writes shipped is read-only and every write command refuses with a message saying to reconnect. `baker ga4 config` reports `canWrite`.
1481
1466
 
@@ -20,9 +20,9 @@ import {
20
20
  shouldEscalate
21
21
  } from "./chunk-2OKSJNLA.js";
22
22
 
23
- // ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js
23
+ // ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
24
24
  var require_safe_stable_stringify = __commonJS({
25
- "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js"(exports, module) {
25
+ "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js"(exports, module) {
26
26
  "use strict";
27
27
  var { hasOwnProperty } = Object.prototype;
28
28
  var stringify = configure2();
@@ -1114,7 +1114,7 @@ function resolveAdaptFormats(params) {
1114
1114
  return params.formats ?? [];
1115
1115
  }
1116
1116
 
1117
- // ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/esm/wrapper.js
1117
+ // ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
1118
1118
  var import__ = __toESM(require_safe_stable_stringify(), 1);
1119
1119
  var configure = import__.default.configure;
1120
1120
  var wrapper_default = import__.default;
@@ -9904,4 +9904,4 @@ export {
9904
9904
  defaultRegistry,
9905
9905
  createEngineFromEnv
9906
9906
  };
9907
- //# sourceMappingURL=chunk-K2IKLMCM.js.map
9907
+ //# sourceMappingURL=chunk-AI4HWQVN.js.map