@koda-sl/baker-cli 0.24.0-dev.55a07065 → 0.25.0-dev.55a07065

package/README.md

@@ -690,64 +690,97 @@ All errors include a `fix` object with `action`, `correctedCommand` (when applic
 
 ### Meta Ads (`baker ads meta`)
 
-Meta Marketing API (Facebook + Instagram). Connect via OAuth in the dashboard, then pick which ad accounts to scope to. Default account ID: `BAKER_META_AD_ACCOUNT_ID` env var or `--account-id` flag (accepts both `act_123` and bare `123`).
+Meta Marketing API (Facebook + Instagram). Connect via OAuth in the dashboard, pick which ad accounts to scope to, then call from the CLI. Account ID via `--account-id act_123` or `BAKER_META_AD_ACCOUNT_ID` env var.
 
-Discovery:
-```
-baker ads meta accounts                                  # accounts in the connected scope
-baker ads meta accounts --include-all                    # every account the token can see
-baker ads meta businesses                                # Business Manager IDs (needed for studies/catalogs)
-```
+The command surface is **curated for AI agents**, not 1:1 with the Marketing API. Smart defaults so an agent doesn't need to remember every flag.
 
-Account-scoped reads:
-```
-baker ads meta account --account-id act_123              # currency, balance, business, status
-baker ads meta currency --account-id act_123             # lightweight currency lookup
-baker ads meta campaigns --account-id act_123 --effective-status ACTIVE,PAUSED
-baker ads meta adsets --campaign-id 6123                 # all adsets in one campaign
-baker ads meta ads --adset-id 6123                       # all ads in one adset
-baker ads meta creatives --account-id act_123            # list creatives
-baker ads meta creatives --creative-id 9988              # single creative
-baker ads meta images --account-id act_123               # AdImages keyed by per-account hash
-baker ads meta labels --account-id act_123
-baker ads meta audiences --account-id act_123            # custom audiences (incl. lookalikes)
-baker ads meta pixels --account-id act_123               # Meta Pixels
-baker ads meta pixels --pixel-id 9988 --stats --days 7   # firing stats
-baker ads meta activities --account-id act_123 --days 14 # account audit log (~90d retention)
-baker ads meta high-demand-periods --campaign-id 6123    # scheduled budget bumps
-```
+#### Common AI questions, mapped to commands
 
-Insights (sync + async):
-```
-baker ads meta insights --object act_123 --level ad --fields impressions,spend,ctr --date-preset last_7d
-baker ads meta insights --object act_123 --preset campaign-performance
-baker ads meta insights --object act_123 --preset placement-breakdown --since 2026-01-01 --until 2026-03-31 --async
-baker ads meta insights --list-presets                   # list built-in presets
-```
+```bash
+# "How is account X doing this week?"
+baker ads meta insights --object act_123
 
-Presets bundled: `campaign-performance`, `creative-performance`, `placement-breakdown`, `device-breakdown`, `audience-breakdown`, `funnel`, `video-performance`. All Meta-native — not parity-aligned with the Google Ads presets.
+# "Which campaigns are profitable?"
+baker ads meta insights --object act_123 --level campaign --intent revenue --date-preset last_28d
 
-Attribution windows: as of Jan 2026 only `1d_view, 1d_click, 7d_click, 28d_click` are functional. Others return empty.
+# "Which creatives need a refresh?"
+baker ads meta insights --object act_123 --level ad --intent ranking --date-preset last_14d
 
-Previews (creative review workflow):
-```
-baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD
-baker ads meta preview --ad-id 9988 --ad-format INSTAGRAM_REELS --out-file /tmp/p.html
-baker ads meta preview --account-id act_123 --creative '{"object_story_spec":{...}}' --ad-format MOBILE_FEED_STANDARD
+# "Where do users drop off the funnel?"
+baker ads meta insights --object act_123 --intent funnel
+
+# "Should we shift budget to Instagram?"
+baker ads meta insights --object act_123 --level adset \
+  --breakdowns publisher_platform,platform_position
+
+# "Why did spend drop yesterday?"
+baker ads meta activities --account-id act_123 --days 7
+
+# "What are we running right now?"
+baker ads meta campaigns --account-id act_123                        # ACTIVE only by default
+baker ads meta ads --account-id act_123 --all-statuses               # widen to everything
+
+# "Tell me about ad 9988"
+baker ads meta creatives --creative-id 9988
+baker ads meta preview --creative-id 9988 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html
+
+# "What audience is this targeting?"
+baker ads meta audiences --account-id act_123
+
+# "Is the pixel firing?"
+baker ads meta pixels --account-id act_123
+baker ads meta pixels --pixel-id 9988 --stats --days 7
 ```
 
-Business-scoped:
+#### Smart defaults (so agents don't enumerate the API)
+
+**`insights`** — the workhorse:
+- `--level account` (override: `campaign|adset|ad`)
+- `--intent baseline` field bundle. Intents available: `baseline`, `revenue`, `funnel`, `ranking`, `video`, `identity`. List with `--list-intents`.
+- `--date-preset last_7d` unless you pass `--since`/`--until`.
+- Filter: `impressions > 0` so undelivered rows don't pollute results. Pass `--include-undelivered` to keep them.
+- Sort: `spend` descending — highest-impact rows first. `--no-sort` to disable.
+- Attribution windows: `7d_click, 1d_view` (only `1d_view, 1d_click, 7d_click, 28d_click` work post Jan 2026).
+- Identity columns (`campaign_name`, `ad_name`, etc.) appended automatically per `--level` so rows are self-describing.
+- 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.
+
+**Listings (`campaigns`/`adsets`/`ads`)** default to `effective_status=ACTIVE` — pass `--all-statuses` to widen, or `--effective-status ACTIVE,PAUSED` for a custom set.
+
+**Pagination** is auto-drained (no manual cursor handling).
+
+#### Full command surface
+
 ```
-baker ads meta studies --business-id 12345               # split tests + lift studies
-baker ads meta studies --study-id 99 --results
-baker ads meta catalogs --business-id 12345              # product catalogs (commerce DPA, hotels, etc.)
+accounts            # ad accounts in the connected scope
+accounts --include-all   # every account the token can see (admin/debug)
+account             # single-account detail (currency, balance, business, status)
+businesses          # /me/businesses
+campaigns           # ACTIVE-only by default
+adsets              # filter by --campaign-id
+ads                 # filter by --adset-id or --campaign-id
+creatives           # list per account, or fetch single via --creative-id
+audiences           # custom audiences (incl. lookalikes)
+pixels              # list, or --stats for one --pixel-id
+activities          # account audit log, ~90d retention
+insights            # see "Smart defaults" above
+preview             # iframe HTML for a creative or ad in a given ad_format
 ```
 
-Notes:
-- Money fields differ between read and write. `spend` is a decimal string in account currency. Budget writes (not yet supported) use integer minor units, with non-uniform offsets (JPY/KRW = 1, KWD/BHD = 1000, most = 100).
-- `effective_status` ≠ `status`. UI should show `effective_status` (e.g. `WITH_ISSUES`, `PENDING_REVIEW`, `DISAPPROVED`, `ADSET_PAUSED`).
-- Account scoping: backend validates every request against the picker selection. Pick accounts via the dashboard "Meta Ads" connection settings before calling these commands.
+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.
+
+#### Auth + caching
+
 - Tokens auto-refresh server-side (60-day rolling long-lived user tokens). On `code 190` reconnect Meta from the dashboard.
+- Account scoping: backend rejects any call against an account not in the picker selection — pick accounts via Settings → Connections → Meta Ads first.
+- All cached actions are keyed per company; two companies that connect to the same Meta account never share cache entries.
+- `--skip-cache` on any command forces a re-fetch.
+
+#### Notes / gotchas
+
+- `spend` is a decimal string in account currency, not an integer.
+- `effective_status` ≠ `status`. The dashboard shows effective_status (e.g. `WITH_ISSUES`, `PENDING_REVIEW`, `DISAPPROVED`, `ADSET_PAUSED`).
+- Meta creatives are effectively immutable once attached. Editing copy/image/CTA = create a new creative + reattach (writes are out of scope for now).
+- Currency offsets are non-uniform (JPY/KRW = 1, KWD/BHD = 1000, most = 100). Read `account.currency` before doing budget math.
 
 ---
 

package/dist/cli.js

@@ -12,7 +12,7 @@ import { videosCommand } from "./commands/videos/index.js";
 const main = defineCommand({
     meta: {
         name: "baker",
-        version: "0.24.0",
+        version: "0.25.0",
         description: `AI-agent CLI for finding and managing images, videos, testimonials, action items, and ad platform data in Baker.
 
 Auth: Set BAKER_API_KEY (starts with bk_) and BAKER_API_URL environment variables.

package/dist/commands/ads/meta/ads.d.ts

@@ -13,7 +13,11 @@ export declare const adsListCommand: import("citty").CommandDef<{
     };
     readonly "effective-status": {
         readonly type: "string";
-        readonly description: "Comma-separated effective_status filter";
+        readonly description: "Comma-separated effective_status filter (overrides default)";
+    };
+    readonly "all-statuses": {
+        readonly type: "boolean";
+        readonly description: "Drop the default ACTIVE filter";
     };
     readonly limit: {
         readonly type: "string";

package/dist/commands/ads/meta/ads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/ads.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0CzB,CAAC"}
+{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/ads.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CzB,CAAC"}

package/dist/commands/ads/meta/ads.js

@@ -1,39 +1,42 @@
 import { defineCommand } from "citty";
 import { apiGet } from "../../../client.js";
 import { writeAdsJson, writeAdsOutput } from "../output.js";
-import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg, resolveEffectiveStatus } from "./shared.js";
 export const adsListCommand = defineCommand({
     meta: {
         name: "ads",
-        description: `List ads in a Meta ad account, optionally scoped by adset or campaign.
+        description: `List ads in a Meta ad account. Defaults to ACTIVE only — pass --all-statuses to widen.
 
 The dashboard shows effective_status (e.g. WITH_ISSUES, PENDING_REVIEW, DISAPPROVED, ADSET_PAUSED), not status.
-preview_shareable_link returns a Meta-hosted URL useful for design review.
+preview_shareable_link returns a Meta-hosted URL useful for design review without calling generatepreviews.
 
 Examples:
   baker ads meta ads --account-id act_123
-  baker ads meta ads --adset-id 6123 --effective-status ACTIVE
-  baker ads meta ads --campaign-id 6123 --output csv`,
+  baker ads meta ads --adset-id 6123
+  baker ads meta ads --campaign-id 6123 --all-statuses
+  baker ads meta ads --account-id act_123 --output csv`,
     },
     args: {
         "account-id": { type: "string", description: "Meta ad account ID" },
         "adset-id": { type: "string", description: "Filter to one adset" },
         "campaign-id": { type: "string", description: "Filter to one campaign" },
-        "effective-status": { type: "string", description: "Comma-separated effective_status filter" },
+        "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+        "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
         limit: { type: "string", description: "Max rows (default 1000)" },
         "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
         output: { type: "string", description: "Output format", default: "json" },
     },
     run: async ({ args }) => {
         const accountId = resolveAccountIdArg(args);
+        const effectiveStatus = resolveEffectiveStatus(args);
         try {
             const params = { "account-id": accountId };
             if (args["adset-id"])
                 params["adset-id"] = args["adset-id"];
             if (args["campaign-id"])
                 params["campaign-id"] = args["campaign-id"];
-            if (args["effective-status"])
-                params["effective-status"] = args["effective-status"];
+            if (effectiveStatus)
+                params["effective-status"] = effectiveStatus;
             if (args.limit)
                 params.limit = args.limit;
             if (args["skip-cache"])

package/dist/commands/ads/meta/ads.js.map

@@ -1 +1 @@
-{"version":3,"file":"ads.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/ads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;;;;;;;;qDAQoC;KAClD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;QAClE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;QAC9F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACjE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,UAAU,CAAC;gBAAE,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,UAAU,CAAW,CAAC;YACtE,IAAI,IAAI,CAAC,aAAa,CAAC;gBAAE,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAW,CAAC;YAC/E,IAAI,IAAI,CAAC,kBAAkB,CAAC;gBAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAW,CAAC;YAC9F,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,mBAAmB,EAAE,MAAM,CAAC,CAAC;YACvF,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"ads.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/ads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE;QACJ,IAAI,EAAE,KAAK;QACX,WAAW,EAAE;;;;;;;;;uDASsC;KACpD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;QAClE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;QAClH,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE;QAClF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACjE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,UAAU,CAAC;gBAAE,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,UAAU,CAAW,CAAC;YACtE,IAAI,IAAI,CAAC,aAAa,CAAC;gBAAE,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAW,CAAC;YAC/E,IAAI,eAAe;gBAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,eAAe,CAAC;YAClE,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,mBAAmB,EAAE,MAAM,CAAC,CAAC;YACvF,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/ads/meta/adsets.d.ts

@@ -9,7 +9,11 @@ export declare const adsetsCommand: import("citty").CommandDef<{
     };
     readonly "effective-status": {
         readonly type: "string";
-        readonly description: "Comma-separated effective_status filter";
+        readonly description: "Comma-separated effective_status filter (overrides default)";
+    };
+    readonly "all-statuses": {
+        readonly type: "boolean";
+        readonly description: "Drop the default ACTIVE filter";
     };
     readonly limit: {
         readonly type: "string";

package/dist/commands/ads/meta/adsets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adsets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/adsets.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCxB,CAAC"}
+{"version":3,"file":"adsets.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/adsets.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCxB,CAAC"}

package/dist/commands/ads/meta/adsets.js

@@ -1,32 +1,35 @@
 import { defineCommand } from "citty";
 import { apiGet } from "../../../client.js";
 import { writeAdsJson, writeAdsOutput } from "../output.js";
-import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg, resolveEffectiveStatus } from "./shared.js";
 export const adsetsCommand = defineCommand({
     meta: {
         name: "adsets",
-        description: `List ad sets in a Meta ad account, optionally scoped to one campaign.
+        description: `List ad sets in a Meta ad account, optionally scoped to one campaign. Defaults to ACTIVE only.
 
 Examples:
   baker ads meta adsets --account-id act_123
-  baker ads meta adsets --campaign-id 6123456789 --effective-status ACTIVE`,
+  baker ads meta adsets --campaign-id 6123456789
+  baker ads meta adsets --campaign-id 6123 --all-statuses`,
     },
     args: {
         "account-id": { type: "string", description: "Meta ad account ID" },
         "campaign-id": { type: "string", description: "Filter to one campaign" },
-        "effective-status": { type: "string", description: "Comma-separated effective_status filter" },
+        "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+        "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
         limit: { type: "string", description: "Max rows (default 1000)" },
         "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
         output: { type: "string", description: "Output format", default: "json" },
     },
     run: async ({ args }) => {
         const accountId = resolveAccountIdArg(args);
+        const effectiveStatus = resolveEffectiveStatus(args);
         try {
             const params = { "account-id": accountId };
             if (args["campaign-id"])
                 params["campaign-id"] = args["campaign-id"];
-            if (args["effective-status"])
-                params["effective-status"] = args["effective-status"];
+            if (effectiveStatus)
+                params["effective-status"] = effectiveStatus;
             if (args.limit)
                 params.limit = args.limit;
             if (args["skip-cache"])

package/dist/commands/ads/meta/adsets.js.map

@@ -1 +1 @@
-{"version":3,"file":"adsets.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/adsets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;2EAI0D;KACxE;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;QAC9F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACjE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,aAAa,CAAC;gBAAE,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAW,CAAC;YAC/E,IAAI,IAAI,CAAC,kBAAkB,CAAC;gBAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAW,CAAC;YAC9F,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,sBAAsB,EAAE,MAAM,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"adsets.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/adsets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE;;;;;0DAKyC;KACvD;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;QAClH,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE;QAClF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACjE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,aAAa,CAAC;gBAAE,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAW,CAAC;YAC/E,IAAI,eAAe;gBAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,eAAe,CAAC;YAClE,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,sBAAsB,EAAE,MAAM,CAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/ads/meta/campaigns.d.ts

@@ -5,7 +5,11 @@ export declare const campaignsCommand: import("citty").CommandDef<{
     };
     readonly "effective-status": {
         readonly type: "string";
-        readonly description: "Comma-separated effective_status filter";
+        readonly description: "Comma-separated effective_status filter (overrides default)";
+    };
+    readonly "all-statuses": {
+        readonly type: "boolean";
+        readonly description: "Drop the default ACTIVE filter and return everything";
     };
     readonly limit: {
         readonly type: "string";

package/dist/commands/ads/meta/campaigns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"campaigns.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/campaigns.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;EAsC3B,CAAC"}
+{"version":3,"file":"campaigns.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/campaigns.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;EAyC3B,CAAC"}

package/dist/commands/ads/meta/campaigns.js

@@ -1,33 +1,36 @@
 import { defineCommand } from "citty";
 import { apiGet } from "../../../client.js";
 import { writeAdsJson, writeAdsOutput } from "../output.js";
-import { csvOrJson, handleMetaError, resolveAccountIdArg } from "./shared.js";
+import { csvOrJson, handleMetaError, resolveAccountIdArg, resolveEffectiveStatus } from "./shared.js";
 export const campaignsCommand = defineCommand({
     meta: {
         name: "campaigns",
-        description: `List campaigns for a Meta ad account.
+        description: `List campaigns for a Meta ad account. Defaults to ACTIVE only — pass --all-statuses to widen.
 
-Note: in Meta's API, "campaign" is what we'd call a campaign group. Status uses effective_status (filterable),
-which can be ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, etc.
+In Meta's API "campaign" is the top-of-tree object (what marketers usually call a campaign group).
+The dashboard shows effective_status: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, etc.
 
 Examples:
-  baker ads meta campaigns --account-id act_123
-  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE,PAUSED
+  baker ads meta campaigns --account-id act_123                                   # ACTIVE only
+  baker ads meta campaigns --account-id act_123 --all-statuses                    # everything
+  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE,PAUSED  # custom set
   baker ads meta campaigns --account-id act_123 --output csv`,
     },
     args: {
         "account-id": { type: "string", description: "Meta ad account ID" },
-        "effective-status": { type: "string", description: "Comma-separated effective_status filter" },
+        "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+        "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter and return everything" },
         limit: { type: "string", description: "Max rows (default 1000)" },
         "skip-cache": { type: "boolean", description: "Bypass server-side cache" },
         output: { type: "string", description: "Output format", default: "json" },
     },
     run: async ({ args }) => {
         const accountId = resolveAccountIdArg(args);
+        const effectiveStatus = resolveEffectiveStatus(args);
         try {
             const params = { "account-id": accountId };
-            if (args["effective-status"])
-                params["effective-status"] = args["effective-status"];
+            if (effectiveStatus)
+                params["effective-status"] = effectiveStatus;
             if (args.limit)
                 params.limit = args.limit;
             if (args["skip-cache"])

package/dist/commands/ads/meta/campaigns.js.map

@@ -1 +1 @@
-{"version":3,"file":"campaigns.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/campaigns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;;;;;6DAQ4C;KAC1D;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;QAC9F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACjE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,kBAAkB,CAAC;gBAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAW,CAAC;YAC9F,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,yBAAyB,EAAE,MAAM,CAAC,CAAC;YAC7F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"campaigns.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/campaigns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE;;;;;;;;;6DAS4C;KAC1D;IACD,IAAI,EAAE;QACJ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACnE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;QAClH,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sDAAsD,EAAE;QACxG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;QACjE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE;KAC1E;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,MAAM,GAA2B,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;YACnE,IAAI,eAAe;gBAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,eAAe,CAAC;YAClE,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;YACpD,IAAI,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAiC,yBAAyB,EAAE,MAAM,CAAC,CAAC;YAC7F,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/ads/meta/index.d.ts

@@ -1,2 +1,17 @@
+/**
+ * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.
+ *
+ * The HTTP backend exposes more endpoints (catalogs, studies, ad-images, labels,
+ * high-demand-periods, currency lookup). They're intentionally not surfaced as
+ * CLI commands because AI agents rarely need them in isolation. Hit them via
+ * curl against the API if you need them.
+ *
+ * Default behaviors that matter:
+ *   - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.
+ *   - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.
+ *   - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).
+ *   - Heavy insights queries auto-fall to async (poll loop hidden).
+ *   - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.
+ */
 export declare const metaCommand: import("citty").CommandDef<import("citty").ArgsDef>;
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/ads/meta/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,WAAW,qDAuDtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,qDAiDtB,CAAC"}

package/dist/commands/ads/meta/index.js

@@ -7,67 +7,70 @@ import { adsetsCommand } from "./adsets.js";
 import { audiencesCommand } from "./audiences.js";
 import { businessesCommand } from "./businesses.js";
 import { campaignsCommand } from "./campaigns.js";
-import { catalogsCommand } from "./catalogs.js";
 import { creativesCommand } from "./creatives.js";
-import { currencyCommand } from "./currency.js";
-import { highDemandPeriodsCommand } from "./high-demand-periods.js";
-import { imagesCommand } from "./images.js";
 import { insightsCommand } from "./insights.js";
-import { labelsCommand } from "./labels.js";
 import { pixelsCommand } from "./pixels.js";
 import { previewCommand } from "./preview.js";
-import { studiesCommand } from "./studies.js";
+/**
+ * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.
+ *
+ * The HTTP backend exposes more endpoints (catalogs, studies, ad-images, labels,
+ * high-demand-periods, currency lookup). They're intentionally not surfaced as
+ * CLI commands because AI agents rarely need them in isolation. Hit them via
+ * curl against the API if you need them.
+ *
+ * Default behaviors that matter:
+ *   - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.
+ *   - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.
+ *   - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).
+ *   - Heavy insights queries auto-fall to async (poll loop hidden).
+ *   - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.
+ */
 export const metaCommand = defineCommand({
     meta: {
         name: "meta",
-        description: `Meta Marketing API (Facebook + Instagram ads).
+        description: `Meta Marketing API — AI-first command surface (Facebook + Instagram ads).
 
 Discovery:
   baker ads meta accounts                                — accounts in this company's connected scope
   baker ads meta accounts --include-all                  — every account the token can see
   baker ads meta businesses                              — Business Manager IDs
 
-Account-scoped:
-  baker ads meta account --account-id act_123
-  baker ads meta currency --account-id act_123
-  baker ads meta campaigns --account-id act_123 --effective-status ACTIVE
+Snapshot a running account (default = ACTIVE only):
+  baker ads meta campaigns --account-id act_123
   baker ads meta adsets --campaign-id 6123
-  baker ads meta ads --account-id act_123 --effective-status ACTIVE
-  baker ads meta creatives --account-id act_123
-  baker ads meta images --account-id act_123
-  baker ads meta labels --account-id act_123
-  baker ads meta audiences --account-id act_123
-  baker ads meta pixels --account-id act_123
-  baker ads meta activities --account-id act_123 --days 14
+  baker ads meta ads --adset-id 6123
+  baker ads meta campaigns --account-id act_123 --all-statuses        — include paused, archived
 
-Insights + previews:
-  baker ads meta insights --object act_123 --preset campaign-performance
-  baker ads meta insights --object act_123 --preset placement-breakdown --async
-  baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html
+Drill in:
+  baker ads meta account --account-id act_123                         — currency, balance, business
+  baker ads meta creatives --creative-id 9988                         — single creative detail
+  baker ads meta audiences --account-id act_123
+  baker ads meta pixels --account-id act_123                          — pixel list
+  baker ads meta pixels --pixel-id 9988 --stats --days 7              — firing health
 
-Business-scoped:
-  baker ads meta studies --business-id 12345
-  baker ads meta catalogs --business-id 12345
+Performance (the workhorse):
+  baker ads meta insights --object act_123                                                    — defaults: level=account, intent=baseline, last_7d
+  baker ads meta insights --object act_123 --intent revenue --date-preset last_28d
+  baker ads meta insights --object act_123 --level ad --intent ranking                        — flag creatives to refresh
+  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age  — placement × age
+  baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31   — auto-async
+  baker ads meta insights --list-presets
 
-Other:
-  baker ads meta high-demand-periods --campaign-id 6123`,
+Audit & review:
+  baker ads meta activities --account-id act_123 --days 14
+  baker ads meta preview --creative-id 9988 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html`,
     },
     subCommands: {
         accounts: accountsCommand,
         account: accountCommand,
-        currency: currencyCommand,
         businesses: businessesCommand,
         campaigns: campaignsCommand,
         adsets: adsetsCommand,
         ads: adsListCommand,
         creatives: creativesCommand,
-        images: imagesCommand,
-        labels: labelsCommand,
         audiences: audiencesCommand,
         pixels: pixelsCommand,
-        studies: studiesCommand,
-        catalogs: catalogsCommand,
-        "high-demand-periods": highDemandPeriodsCommand,
         activities: activitiesCommand,
         insights: insightsCommand,
         preview: previewCommand,

package/dist/commands/ads/meta/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDA8BuC;KACrD;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,iBAAiB;QAC7B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,cAAc;QACnB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,eAAe;QACzB,qBAAqB,EAAE,wBAAwB;QAC/C,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;KACxB;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/ads/meta/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oGA8BmF;KACjG;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;QACvB,UAAU,EAAE,iBAAiB;QAC7B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,GAAG,EAAE,cAAc;QACnB,SAAS,EAAE,gBAAgB;QAC3B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,cAAc;KACxB;CACF,CAAC,CAAC"}

package/dist/commands/ads/meta/insights.d.ts

@@ -1,24 +1,24 @@
 export declare const insightsCommand: import("citty").CommandDef<{
     readonly object: {
         readonly type: "string";
-        readonly description: "Object ID — act_<id> for account, or campaign/adset/ad ID";
+        readonly description: "Object ID — act_<id> for account, or a campaign/adset/ad ID";
         readonly required: true;
     };
     readonly level: {
         readonly type: "string";
-        readonly description: "account|campaign|adset|ad";
+        readonly description: "account|campaign|adset|ad (default: account)";
     };
-    readonly fields: {
+    readonly intent: {
         readonly type: "string";
-        readonly description: "Comma-separated fields list";
+        readonly description: "baseline|revenue|funnel|ranking|video|identity (default: baseline)";
     };
-    readonly preset: {
+    readonly fields: {
         readonly type: "string";
-        readonly description: "Insights preset name";
+        readonly description: "Comma-separated field list (overrides --intent bundle)";
     };
-    readonly "list-presets": {
+    readonly "list-intents": {
         readonly type: "boolean";
-        readonly description: "List available presets and exit";
+        readonly description: "Print available intents and exit";
     };
     readonly "date-preset": {
         readonly type: "string";
@@ -38,19 +38,23 @@ export declare const insightsCommand: import("citty").CommandDef<{
     };
     readonly breakdowns: {
         readonly type: "string";
-        readonly description: "Comma-separated breakdowns";
+        readonly description: "Comma-separated breakdowns (e.g. publisher_platform,age)";
     };
     readonly "action-breakdowns": {
         readonly type: "string";
-        readonly description: "Comma-separated action_breakdowns";
+        readonly description: "Slice the actions[] array (default: action_type for revenue/funnel)";
     };
     readonly filtering: {
         readonly type: "string";
-        readonly description: "JSON array of {field,operator,value}";
+        readonly description: "Override default filter — JSON array of {field,operator,value}";
+    };
+    readonly "include-undelivered": {
+        readonly type: "boolean";
+        readonly description: "Keep rows where impressions=0 (off by default)";
     };
     readonly "attribution-windows": {
         readonly type: "string";
-        readonly description: "Comma-separated. Only 1d_view, 1d_click, 7d_click, 28d_click work as of Jan 2026";
+        readonly description: "Override default 7d_click,1d_view (only 1d_view, 1d_click, 7d_click, 28d_click work post Jan 2026)";
     };
     readonly "use-account-attribution": {
         readonly type: "boolean";
@@ -62,11 +66,19 @@ export declare const insightsCommand: import("citty").CommandDef<{
     };
     readonly limit: {
         readonly type: "string";
-        readonly description: "Max rows (default per preset)";
+        readonly description: "Max rows (default 1000)";
     };
     readonly async: {
         readonly type: "boolean";
-        readonly description: "Submit as async job, poll, then dump results";
+        readonly description: "Force async submit-and-poll path";
+    };
+    readonly "no-async": {
+        readonly type: "boolean";
+        readonly description: "Refuse the auto-async fallback for heavy queries";
+    };
+    readonly "no-sort": {
+        readonly type: "boolean";
+        readonly description: "Skip default spend-desc sort";
     };
     readonly "skip-cache": {
         readonly type: "boolean";

package/dist/commands/ads/meta/insights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"AAqHA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2F1B,CAAC"}
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../../src/commands/ads/meta/insights.ts"],"names":[],"mappings":"AAwLA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiG1B,CAAC"}