@koda-sl/baker-cli 0.498.0 → 0.500.0

package/README.md

@@ -178,6 +178,93 @@ Multi-platform ad commands. Google, Meta, and LinkedIn support both reads and **
 
 ---
 
+### `baker ads performance`
+
+Every connected ad platform's numbers from Baker's stored copy (refreshed every few hours, full history), without calling the platforms. Read-only. Results are the company's chosen conversion goals, else each platform's headline conversions; money is shown in the company's reporting currency at the period's average ECB rate (`--currency <ISO>` for another, `--currency native` for each ad account's own), and comparisons use only days whose conversions have settled.
+
+It is the first read for any ads report, analysis or alert: no rate limit and the whole history, a few hours behind (`status` says how fresh). The live `baker ads <platform>` reads are for today's numbers and what this lacks, and their answers name the synced command that covers the same question.
+
+```bash
+baker ads performance overview --days 30          # spend, results, cost per result per platform, vs the period before
+baker ads performance setup                       # is everything set up: one headline and what to fix, in order
+baker ads performance accounts --days 30          # each ad account against its own target, with its weeks
+baker ads performance accounts --days 180 --grain month   # the same table read by month, as the dashboard at that grain
+baker ads performance trend --days 90 --grain week --group-by campaign   # spend and results over time, split one way (the dashboard's charts)
+baker ads performance entity <id> --platform meta --level campaign --whole-run   # over its whole run, not the period
+baker ads performance creatives --ad-group-ids <id>   # one ad set's creatives (or --creative-keys <groupKey> for one creative)
+baker ads performance budgets --currency USD   # the budgets with amounts in one currency
+baker ads performance attention                   # the few things that matter most now: fix now, worth a look, opportunities
+baker ads performance attention claim <id>        # this chat works on it (at once; lapses when the chat ends)
+baker ads performance attention fixed <id> --note "Cut the budget 20%"   # staged: at Publish it shows "Fixed, checking it worked"
+baker ads performance attention dismiss <id> --wrong --reason "Paused on purpose"   # staged; without --wrong it is "not now"
+baker ads performance attention restore <id>      # staged: a dismissed alert back on the list at Publish
+baker ads performance targets alert-lines --cost-rise-pct 40 --overspend-pct default   # staged: how sensitive two alerts are
+baker ads performance currency                    # the reporting currency, why it is the one, and what it can be
+baker ads performance currency set USD            # staged: the default currency for everyone (--clear to go back)
+baker ads performance entities --level ad --sort cost_per_result
+baker ads performance entities --level ad --entity-ids <id,id>   # only these rows
+baker ads performance entities --platforms google --compare   # each row against the settled days before; what stopped, and who stopped it
+baker ads performance entity <id> --platform meta --level ad_group   # one entity + verdict before changing it
+baker ads performance changes --days 14
+baker ads performance impact --actor-kinds baker
+baker ads performance creatives   # each row also names the Baker creative (and version) it is: madeInBaker
+baker ads performance creative-health --sections trending,poor   # trending creatives, poor performers, launch hit rate, freshness
+baker ads performance families --by hook   # launched creatives by winning-ads library family, hook, angle, framework… with real spend and results
+baker ads performance families choices <groupKey>   # the library families an unsettled creative may be, best first
+baker ads performance families link <libraryKey or groupKey> --family <id> --name "Spring video"   # staged; or --not-in-library, --auto; --name required
+baker ads performance creative-assets --ad-ids <id>   # every version of an ad's pictures and videos, stored at full size
+baker ads performance health --platforms meta   # spend vs last month, cost per result, budget in learning, audiences, copy, frequency
+baker ads performance breakdown --dimension placement   # also country, device; Meta: age, gender, audience_segment
+baker ads performance search-terms --zero-results
+baker ads performance search-terms --term-segments brand --campaign-segments non_brand   # brand searches bought by non-brand campaigns
+baker ads performance brand-split --days 30      # Google Search: brand, competitor and non-brand apart, each against its own target
+baker ads performance impression-share           # per Search campaign: share, lost to budget / ad rank, top of page, change in points
+baker ads performance keyword-quality --max-quality-score 5   # quality score and its parts, and the pages keywords lead to
+baker ads performance google-report --days 7     # every section of a Google Ads review in one read
+baker ads performance budgets                    # monthly budgets and how this month paces against each
+baker ads performance pacing --month 2026-10
+baker ads performance funnel --level campaign
+baker ads performance tracking
+baker ads performance landings
+baker ads performance live-in --landing <slug>   # live campaigns sending people to a landing; --creative <slug> for the ads showing a creative
+baker ads performance goals                      # --start/--end, --platforms, --ad-account-ids as the Conversions card reads them
+baker ads performance status                     # freshness per account; adsInManyAdGroups names ads counted under two ad groups
+baker ads performance people --level campaign  # who each campaign brought, how far up the ladder, cost per step
+baker ads performance people --level ad --ad-group-ids <id>  # the same, for the ads inside one ad set
+baker ads performance personas --dimension role  # the same people by role, company size, industry...
+baker ads performance ladder                     # the lead-to-customer steps and what they can be made of
+baker ads performance persona-fields             # which Form fields say who people are
+baker ads performance progress --status worsening  # worst first: really getting worse, how sure, and why
+baker ads performance diagnose <id> --platform meta --level campaign   # one entity: what moved, findings, weekly line
+baker ads performance pulse                      # last settled day against the 7 before, per ad account
+baker ads performance anomalies --cpa-spike 0.3  # unusual days in the last 2 settled weeks, what carried them, event health
+baker ads performance recap --days 7             # the week's changes as plain sentences: what, where, who, when
+baker ads performance targets --days 30          # per ad account and event: numbers against the target, what counts as a result
+baker ads performance targets set --platform meta --account 123 --event offsite_conversion.fb_pixel_lead --cost 25 --currency EUR
+baker ads performance targets set --company --roas 3   # the company default; --clear removes a target
+baker ads performance targets unstage --all      # take back what this chat staged
+baker ads performance goals set --platform google --account 456 --count "Lead form" --uncount Calls
+baker ads performance goals name --singular "demo request" --plural "demo requests"   # what the company calls a result; --reset
+baker ads performance budget-recommendations --moves scale,cut   # scale, hold, cut or pause each campaign against the target that judges it (its brand/non-brand target, else its account's, else the default)
+baker ads performance segments                   # the brand and competitor names, a person's choices, segment targets
+baker ads performance segments set --brand "Acme, acme.com" --competitors "Globex"
+baker ads performance segments set --campaign <id> --account <id> --segment brand   # or --term "<term>"; --clear
+baker ads performance segments set --target non_brand --cost 40 --currency EUR
+baker ads performance budgets set --amount 45000 --currency USD   # --platform --account [--segment brand] for one account
+```
+
+Brand, competitor and non-brand are read per search term and keyword by Baker's decision model against the brand and competitor names, and per campaign from what its keywords spent on; a person's choice always wins.
+
+`goals set` takes conversion action names exactly as `targets` lists them; write a comma inside one name as `\,` (`--count 'Leads\, all,Calls'`). A comma list that splits into a name the account does not have is refused with the escaped form and the closest names; a single unseen name stages with a spelling hint. `targets set`, `goals set`, `goals name`, `segments set` and `budgets set` stage on the chat (they need `BAKER_CHAT_ID`) and apply when it is published; a target someone changes in the dashboard meanwhile is kept and the staged one reported as not applied. Event targets are Meta and LinkedIn only — the other platforms cannot split spend by event.
+
+`progress` and `diagnose` judge the last 2 settled weeks against the 4 before, on the metric each entity is for (falling back to cost per click when results are too few), and separate a real decline from a measurement change (`not_comparable`), the market, scaling, fatigue, one child, the landing page and noise, with a confidence.
+
+Compact by default; `--full` returns every field. Errors with `ADS_NOT_CONNECTED` (and a `fix`) when no ad platform is connected.
+
+`search-terms` and `breakdown` are compact too; `--full` returns every row and field. `brand-split`, `impression-share`, `keyword-quality` and `google-report` read Google Ads only and no longer take `--platforms`; `entity` and `diagnose` are about one entity and no longer take `--platforms` or `--campaign-ids`. On `tracking` and `landings`, `--ad-account-ids` and `--campaign-ids` narrow only the ad numbers, never the visits.
+
+A call the command cannot run stops with an `INVALID_ARGS` envelope naming the flag, before anything is read: a missing required argument, an unknown subcommand, a stray positional, or a flag passed with nothing in it (`--ad-account-ids ","`, `--landing ""`) — an empty list would otherwise read everything. A `--currency` Baker has no exchange rate for is refused with a `fix` pointing at `baker ads performance currency` (`canShowIn`), or `native`.
+
 ### `baker ads terms`
 
 Whether an ad account (and its Facebook Pages) has accepted the platform terms that customer lists, buyer audiences, conversion uploads with email or phone, website audiences and lead forms need. Read live; per term: `status` (`accepted` | `not_accepted` | `unknown`), what needs it, who can accept it, numbered steps and a link. `--full` adds the field each status was read from.
@@ -418,19 +505,19 @@ The same lines also go to stderr. A read with nothing to report prints none of i
 
 | Preset                 | Description                              | Default date range |
 |------------------------|------------------------------------------|--------------------|
-| `campaign-performance` | Campaign metrics overview                | LAST_30_DAYS       |
+| `campaign-performance` | Campaign metrics, all conversions included, and bidding type | LAST_30_DAYS |
 | `conversions-by-action` | Which conversion action each campaign's conversions actually are | LAST_30_DAYS |
-| `keyword-analysis`     | Keyword performance per ad group         | LAST_30_DAYS       |
+| `keyword-analysis`     | Keyword performance per ad group, with first-page, top-of-page and first-position CPC estimates | LAST_30_DAYS |
 | `keyword-serving`      | Why a keyword is limited — status reasons, first-page bid estimate vs max CPC, quality score | ALL_TIME |
 | `positive-keywords`    | Positive (targeting) keywords only       | ALL_TIME           |
 | `negative-keywords`    | Negative (blocking) keywords only        | ALL_TIME           |
 | `negative-keyword-lists`   | Shared negative lists + their terms  | ALL_TIME           |
 | `negative-list-attachments`| Which campaigns each shared list covers | ALL_TIME        |
-| `search-terms`         | Actual user queries triggering ads       | LAST_7_DAYS        |
-| `ad-copy-performance`  | Ad headline/description effectiveness    | LAST_30_DAYS       |
+| `search-terms`         | Actual user queries triggering ads, with the match type that matched | LAST_7_DAYS |
+| `ad-copy-performance`  | Every ad's metrics, cost included, with RSA headlines/descriptions | LAST_30_DAYS |
 | `asset-performance`    | PMax assets: serving status + metrics    | LAST_30_DAYS       |
 | `shopping-products`    | Product-level shopping metrics           | LAST_30_DAYS       |
-| `account-summary`      | Account-level totals                     | LAST_30_DAYS       |
+| `account-summary`      | Account-level totals, all conversions included | LAST_30_DAYS |
 | `pmax-channels`        | PMax spend/results per channel (Search, YouTube, Display, …) | LAST_30_DAYS |
 | `pmax-placements`      | Where PMax ads showed (impressions)      | LAST_30_DAYS       |
 | `placements`           | Display / Video / Demand Gen placements with cost and conversions | LAST_30_DAYS |
@@ -439,6 +526,8 @@ The same lines also go to stderr. A read with nothing to report prints none of i
 | `geo-performance`      | Results by country and location type (in vs interested in) | LAST_30_DAYS |
 | `age-performance` / `gender-performance` | Results by age range / gender per ad group | LAST_30_DAYS |
 | `ai-max-search-terms`  | AI Max search terms with the headline and landing page used | LAST_30_DAYS |
+| `bidding-strategy-performance` | Portfolio bidding strategies: type, status, targets and metrics | LAST_30_DAYS |
+| `conversion-tags`      | Website and call conversions' tracking code (Google tag + event snippet) | — |
 | `account-budget`       | Account budget: limit, served, pending change | —               |
 | `recommendations`      | Google's open recommendations with impact | —                 |
 | `campaign-simulations` / `keyword-bid-simulations` | Google's what-if points (budget, tCPA, tROAS, CPC bid) | — |
@@ -1689,6 +1778,7 @@ baker analytics events --steps hero_view,pricing_view,demo_click   # an ordered
 baker analytics devices --grain viewport  # which widths the page has to survive
 baker analytics geo --grain postal_code --country ES
 baker analytics bots                      # which crawlers fetch the site
+baker analytics companies --targets targets.csv  # which target accounts visited (by their own network; consented visitors only)
 baker analytics presets                   # what each report answers
 baker analytics ads --platform google     # what Google's traffic carries, in Google's vocabulary
 baker analytics tracking                  # do the ad URLs carry the campaign, ad group and ad at all
@@ -1712,6 +1802,7 @@ baker analytics sites                     # the websites the measurement tag is
 baker analytics sites --add example.com   # and every subdomain of it — applies at once, no publish
 baker analytics website-tag               # the tag for a site Baker does not publish, with the key in it
 baker analytics sends                     # where each system event is sent, and what happened to each upload
+baker analytics sends --history           # when each send was set up, and whether its integration was removed
 baker analytics sends --set --source-event page:deal_won --platform meta --tag <tagId> --event Purchase   # staged; spends budget once published
 baker analytics sends --set --source-event page:deal_won --platform meta --tag <tagId> --event Purchase --parameter content_name={{properties.plan}}   # with an extra Meta custom_data parameter
 baker analytics sends --uploads s1 --failed   # the uploads Meta refused, each with the event and Meta's own words
@@ -2310,6 +2401,148 @@ A Reddit thread link is not sent to Firecrawl (which refuses Reddit): it is read
 
 ---
 
+### `baker research linkedin-person <profile url>`
+
+Read one person's public LinkedIn profile once, to write a 1:1 ad or account page from their own stated priorities. Nothing is stored or followed.
+
+```bash
+baker research linkedin-person https://www.linkedin.com/in/jane-doe
+baker research linkedin-person https://es.linkedin.com/in/jane-doe --full
+```
+
+**Response:**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "private": false,
+    "profile_url": "https://www.linkedin.com/in/jane-doe",
+    "name": "Jane Doe",
+    "location": "Madrid, Spain",
+    "about": "I help mid-market retailers move stock planning off spreadsheets.",
+    "current_role": { "organization": "Acme Logistics", "organization_url": "https://www.linkedin.com/company/acme-logistics", "location": "Madrid", "since": "2021-07", "description": null },
+    "recent_posts": [{ "text": "Stock-outs cost us more than overstock last year.", "date": "2026-10-16T21:17:59.571Z", "url": "https://www.linkedin.com/posts/...", "kind": "Post" }],
+    "articles": [{ "title": "Why we stopped forecasting by hand", "date": "2026-10-08T15:14:03.000+00:00", "url": "https://www.linkedin.com/pulse/..." }]
+  },
+  "hints": ["For ad and page messaging only; nothing is stored — quote their stated priorities into the creative brief ..."]
+}
+```
+
+| Flag     | Description                                                                 |
+|----------|-----------------------------------------------------------------------------|
+| `--full` | Also return the provider's whole answer as `raw`                            |
+
+- Any `linkedin.com/in/<name>` link works, country subdomains included; company pages are refused.
+- LinkedIn no longer shows headlines or job titles publicly, so `current_role` is the organisation (the first on the profile with no end date), never a title.
+- A profile LinkedIn hides returns `{ "private": true }` and is not charged. Cached 24 hours per profile.
+
+---
+
+### `baker research transcript <url>`
+
+The words of one long recording — a keynote, earnings call, webinar or podcast. A YouTube link is read from its captions; any other link must be the audio or video file itself (`.mp3`, `.mp4`, `.m4a`, …) and is transcribed. Nothing is added to the video library.
+
+```bash
+baker research transcript "https://www.youtube.com/watch?v=<id>"
+baker research transcript "https://www.youtube.com/watch?v=<id>" --out keynote.txt
+baker research transcript "https://traffic.megaphone.fm/<episode>.mp3" --full
+```
+
+**Response (default):**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "url": "https://www.youtube.com/watch?v=<id>",
+    "provider": "youtube",
+    "title": "Keynote 2026",
+    "duration_sec": 2712.4,
+    "language": "English",
+    "word_count": 7120,
+    "text_chars": 40211,
+    "truncated": false,
+    "excerpt": "Good morning everyone..."
+  },
+  "hints": ["This is the opening excerpt. Re-run with `--out <file>` ..."]
+}
+```
+
+| Flag           | Description                                                              |
+|----------------|--------------------------------------------------------------------------|
+| `--full`       | Return the whole text as `text` instead of the first 3,000 characters    |
+| `--out <file>` | Write the whole text to the file and return its path as `file`           |
+
+- `provider` is `youtube` (captions) or `deepgram` (the recording transcribed); `title` comes back for YouTube only.
+- A podcast's episode page is not a recording — pass its download link (the RSS `enclosure`). A page link is refused with that fix.
+- Cached 7 days per link, so `--full` or `--out` after a first look costs nothing more.
+
+---
+
+### `baker research company <domain>` / `--search`
+
+What one company is and whether it is hiring, to fill, score and message a target-account list — or, with `--search`, the companies whose main industry, size, revenue and HQ country match, to size a market and build the list. Firmographics and site technologies come from The Companies API, hiring from PredictLeads job openings.
+
+```bash
+baker research company --search --industry computer-software,software-development --size 50-200 --country es --count
+baker research company --search --industry computer-software,software-development --size 50-200 --revenue 1m-10m,10m-50m --country es --limit 25
+baker research company acme.es
+baker research company acme.es --no-hiring
+baker research company https://www.acme.es/about --full
+```
+
+**Response (lookup):**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "domain": "acme.es",
+    "name": "Acme Logística",
+    "industry": "logistics-and-supply-chain",
+    "employees": "200-500",
+    "employees_exact": 312,
+    "hq_country": "Spain",
+    "hq_country_code": "es",
+    "hq_city": "Madrid",
+    "revenue": "50m-100m",
+    "founded": 1998,
+    "linkedin_url": "https://www.linkedin.com/company/acme-logistica",
+    "description": "Acme moves pallets across Iberia.",
+    "technologies": ["hubspot", "google-tag-manager"],
+    "technologies_total": 2,
+    "hiring": { "status": "ok", "open_jobs": 42, "new_last_30_days": 9, "top_titles": ["Account Executive"], "top_functions": [{ "function": "sales", "jobs": 12 }] }
+  }
+}
+```
+
+**Response (`--search`):** `{ "total": 1840, "page": 1, "last_page": 74, "companies": [{ "name", "domain", "industry", "employees", "revenue", "country" }] }`; with `--count`, `{ "total": 112 }`.
+
+| Flag | Description |
+|---|---|
+| `--search` | List companies matching the filters instead of reading one |
+| `--count` | With `--search`: the number of matches alone — free. Size the market with it before paying for rows |
+| `--industry <a,b>` | Main-industry slugs, comma-separated, any matching (`computer-software,software-development`). Each is checked first, free: one that is no slug is refused with the closest slugs and how many companies each matches under your other filters |
+| `--size <a,b>` | Employee bands: `1-10`, `10-50`, `50-200`, `200-500`, `500-1k`, `1k-5k`, `5k-10k`, `over-10k` |
+| `--revenue <a,b>` | Revenue bands (USD): `under-1m`, `1m-10m`, `10m-50m`, `50m-100m`, `100m-200m`, `200m-1b`, `over-1b` |
+| `--country <a,b>` | HQ country codes (ISO 3166-1 alpha-2) |
+| `--limit <n>` | Companies per page, 1-100 (default 25); each returned is billed |
+| `--page <n>` | Page to read (default 1) |
+| `--no-hiring` | Lookup: skip hiring, which costs ~20× the profile — for filling a long list |
+| `--full` | Every industry and technology, plus both providers' answers as `raw` |
+
+- Search filters on the company's **main** industry; a search hint names related industries left out, with the companies each would add under your other filters, to widen on purpose.
+- A bad `--size`, `--revenue` or `--country` is a `VALIDATION_ERROR` naming the allowed values, before any call.
+- The domain is reduced to its registrable domain (`shop.acme.co.uk` → `acme.co.uk`), the way account matching keys companies.
+- A thin profile (two of LinkedIn page, HQ country and employee band missing, or `1-10` employees) comes back with a hint to check the domain is the company's main website — a namesake often sits on a neighbouring domain (`factorial.es` vs `factorialhr.com`).
+- `name` is the provider's spelling; prefer the name on the company's LinkedIn page or site when they differ.
+- `hiring.status` is `ok`, `not_tracked` (unknown — not "not hiring"), `skipped` (`--no-hiring`) or `unavailable` (not read; the firmographics still come back, with a hint).
+- Needs `THE_COMPANIES_API_KEY` on the backend; without it both modes answer `CONFLICT` "Company data isn't switched on for this workspace yet". Hiring needs `PREDICTLEADS_API_KEY` and `PREDICTLEADS_API_TOKEN`.
+- Profiles are cached 30 days, hiring and searches 7 days, per company.
+
+---
+
 ### `baker research reddit subreddits` / `search` / `thread`
 
 Read Reddit verbatim. Reddit refuses ordinary web reads, Firecrawl, and datacenter addresses, so these commands read it through a ladder of sources — Reddit's own API (when the backend holds `REDDIT_CLIENT_ID` / `REDDIT_CLIENT_SECRET`), the Arctic Shift public archive, then Reddit's public JSON through the proxy tiers — and report which one answered.
@@ -4067,6 +4300,8 @@ Triggers:
 | `experiment.concluded` | The winner has been moved into the page | `--experiment <id>` |
 | `task.completed` | A Task is closed | `--tag <slug>` |
 | `task.claimed` | An agent picks up a Task | `--tag <slug>` |
+| `ad_alert.opened` | Baker raises an ad alert (new, back, or a fix that did not hold) | `--ad-account <platform>:<id>`, `--alert <rule>` |
+| `ad_alert.claimed` / `ad_alert.fixed` / `ad_alert.closed` | An ad alert is picked up, marked fixed, or leaves the list (`how` says why) | `--ad-account`, `--alert` |
 
 Rules:
 
@@ -4598,13 +4833,14 @@ baker accounts company acme.com                        # or a LinkedIn company i
 baker accounts campaigns --last-months 6 --output md   # per campaign: reached, engaged, influenced pipeline (--basis revenue)
 baker accounts influenced --model awareness --threshold 10 --output csv   # another rule, this call only
 baker accounts warm --min 0                            # every New/Rising company, below the threshold too
+baker accounts engagement --targets targets.csv        # only the target accounts; targets: reached/engaged per tier, notReached
 baker accounts crm status                              # deals from HubSpot or sent by the client; what arrived, linked Google Sheets
 baker accounts crm sheet                               # create and link the deals sheet in the client's Google Drive
 baker accounts crm check --file deals.csv              # judge a deals or company CSV offline, nothing sent
 baker accounts crm contract                            # the send-your-CRM contract, as Markdown for a developer
 ```
 
-A deal is **influenced** when its company reached the company's influence rule — by default 3+ LinkedIn ad engagements (Awareness: 7+ impressions; Intent: 3+ clicks) — in the 12 months up to and including the month the deal was created (`--basis pipeline`, deals not won) or closed won (`--basis revenue`). It is a labelled rule, not credit: campaign rows overlap, and money is reported per currency, never summed across currencies. Deals whose company match is only a guess come back under `lowConfidence` and stay out of `summary` until the match is confirmed in Measure → Accounts. Without the deals set up there — HubSpot's pipelines and won/lost stages, or Another CRM — `influenced` and `campaigns` exit 1 with `ACCOUNTS_NOT_SET_UP`. A CRM Baker cannot read sends its companies and deals to `POST /v1/accounts/crm` (a `crm_ingest` key, `X-Baker-Mode: test` to rehearse, up to 500 records per request, records naming a person refused), is uploaded as a CSV in Measure → Accounts, or lives in a Google Sheet linked there that Baker reads every night (a row deleted from the sheet leaves Baker). A file is a deals export or a company list — a company needs only its website or LinkedIn page; `crm check` runs the same rules offline and `crm contract` prints the whole contract. The CLI never sends deals or links a sheet of the client's; `crm sheet` creates the empty deals sheet in their Google Drive and links it, applied at once (asking again returns the same sheet). `--model engagement|awareness|intent` and `--threshold N` on `influenced`, `campaigns` and `warm` read with another rule for that call only; the saved setting is unchanged. A **warm** account is New or Rising, reached the company's influence threshold this period on the rule's metric (`--min N` overrides, `--min 0` drops it), and has no open deal, no won deal and no deal lost in the last 6 months; `engagement` and `warm` rows carry `dealStatus` (`won` > `open` > `lost` > `none`), `engagement --output csv` adds `lastMonth` and `previousImpressions/Clicks/Engagements`, and `campaigns` / `company` carry each campaign's `campaignName` (null when LinkedIn could not name it). `company` returns `months` (the company's totals), `byCampaign` (the same numbers per campaign — overlapping, never add them) and its `deals` with `touchValue` and `influenced`. `warm --output csv` is the file `baker ads linkedin audiences create --type company-list --list-file` takes.
+A deal is **influenced** when its company reached the company's influence rule — by default 3+ LinkedIn ad engagements (Awareness: 7+ impressions; Intent: 3+ clicks) — in the 12 months up to and including the month the deal was created (`--basis pipeline`, deals not won) or closed won (`--basis revenue`). It is a labelled rule, not credit: campaign rows overlap, and money is reported per currency, never summed across currencies. Deals whose company match is only a guess come back under `lowConfidence` and stay out of `summary` until the match is confirmed in Measure → Accounts. Without the deals set up there — HubSpot's pipelines and won/lost stages, or Another CRM — `influenced` and `campaigns` exit 1 with `ACCOUNTS_NOT_SET_UP`. A CRM Baker cannot read sends its companies and deals to `POST /v1/accounts/crm` (a `crm_ingest` key, `X-Baker-Mode: test` to rehearse, up to 500 records per request, records naming a person refused), is uploaded as a CSV in Measure → Accounts, or lives in a Google Sheet linked there that Baker reads every night (a row deleted from the sheet leaves Baker). A file is a deals export or a company list — a company needs only its website or LinkedIn page; `crm check` runs the same rules offline and `crm contract` prints the whole contract. The CLI never sends deals or links a sheet of the client's; `crm sheet` creates the empty deals sheet in their Google Drive and links it, applied at once (asking again returns the same sheet). `--model engagement|awareness|intent` and `--threshold N` on `influenced`, `campaigns` and `warm` read with another rule for that call only; the saved setting is unchanged. A **warm** account is New or Rising, reached the company's influence threshold this period on the rule's metric (`--min N` overrides, `--min 0` drops it), and has no open deal, no won deal and no deal lost in the last 6 months; `engagement` and `warm` rows carry `dealStatus` (`won` > `open` > `lost` > `none`), `engagement --output csv` adds `lastMonth` and `previousImpressions/Clicks/Engagements`, and `campaigns` / `company` carry each campaign's `campaignName` (null when LinkedIn could not name it). `company` returns `months` (the company's totals), `byCampaign` (the same numbers per campaign — overlapping, never add them) and its `deals` with `touchValue` and `influenced`. `warm --output csv` is the file `baker ads linkedin audiences create --type company-list --list-file` takes. `--targets <file>` on `engagement`, `influenced`, `campaigns` and `warm` narrows the report to an ABM target list — a CSV with a domain or website column (name and tier optional) or a JSON array of domains or `{domain, name, tier}` — reduced to registrable domains; rows, totals and pages count the targets only, and the answer adds `targets` `{total, reached, engaged, notReached, byTier}`.
 
 ---
 

package/dist/account-PYK5VMQ4.js

@@ -0,0 +1,80 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-EBEZFAUH.js";
+import "./chunk-ZRP7Y2DM.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/account.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.chatgpt.account",
+  description: "The connected ChatGPT Ads account: name, currency, timezone, status, and the brand and account reviews that decide whether anything in it can serve.",
+  args: {
+    full: { type: "boolean", description: "Return ChatGPT Ads' own account object", required: false }
+  }
+});
+function accountHints(account) {
+  const hints = [];
+  if (account.brandReview.status !== "approved") {
+    const reason = account.brandReview.reason ? ` (${account.brandReview.reason})` : "";
+    hints.push(
+      `Brand review is ${account.brandReview.status}${reason}: nothing in this account serves until it is approved. Fix it in ChatGPT Ads Manager before changing campaigns.`
+    );
+  }
+  if (account.accountReview && account.accountReview.status !== "approved") {
+    hints.push(`A separate account review is ${account.accountReview.status}; delivery can wait on it too.`);
+  }
+  if (account.status === "paused") {
+    hints.push("The whole account is paused, so no campaign in it serves whatever its own status says.");
+  }
+  return hints;
+}
+var SHOW_ARGS = {
+  full: { type: "boolean", description: "Return ChatGPT Ads' own account object", required: false }
+};
+var accountShowCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "The connected ChatGPT Ads account. Example: baker ads chatgpt account"
+  },
+  args: SHOW_ARGS,
+  run: async ({ args }) => {
+    await runChatgptRead(
+      CHATGPT_ADS_REFERENCE.account,
+      () => apiGet("/api/ads/chatgpt/account", args.full ? { full: "true" } : void 0),
+      (account) => args.full ? [] : accountHints(account)
+    );
+  }
+});
+var accountCommand = defineCommand({
+  meta: {
+    name: "account",
+    description: `The connected ChatGPT Ads account. Start here: currency and timezone for every figure, and whether reviews let anything serve.
+
+Examples:
+  baker ads chatgpt account
+  baker ads chatgpt account --full
+  baker ads chatgpt account update --favicon-url https://example.com/icon.png   \u2014 staged; applies on publish`
+  },
+  subCommands: {
+    show: accountShowCommand,
+    update: () => import("./account-writes-4MAKFM7L.js").then((m) => m.accountUpdateCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args: SHOW_ARGS,
+  default: "show"
+});
+export {
+  accountCommand,
+  accountHints
+};
+//# sourceMappingURL=account-PYK5VMQ4.js.map

package/dist/account-YSMZB5ZC.js

@@ -0,0 +1,80 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-I46D7YXI.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-5MSRVAUZ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-ERSL4WZT.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/account.ts
+import { defineCommand } from "citty";
+var accountDetailCommand = defineCommand({
+  meta: {
+    name: "detail",
+    description: `Single LinkedIn ad account detail (currency, status, type).
+
+Examples:
+  baker ads linkedin account --account-id 503001492
+  baker ads linkedin account --account-urn urn:li:sponsoredAccount:503001492 --output md`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/account", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput([data], fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var accountCommand = defineCommand({
+  meta: {
+    name: "account",
+    description: `LinkedIn ad account: its detail, and the settings that apply across every ad set in it.
+
+Examples:
+  baker ads linkedin account --account-id 503001492                          \u2014 currency, status, type
+  baker ads linkedin account url-params --param utm_source=linkedin          \u2014 UTMs for every ad in the account`
+  },
+  subCommands: {
+    detail: accountDetailCommand,
+    "url-params": () => import("./write-commands-Z556OHHH.js").then((m) => m.accountUrlParamsCommand)
+  },
+  args: accountDetailCommand.args,
+  default: "detail"
+});
+export {
+  accountCommand
+};
+//# sourceMappingURL=account-YSMZB5ZC.js.map

package/dist/account-ZY655BIU.js

@@ -0,0 +1,139 @@
+import {
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-B2POVFR2.js";
+import "./chunk-Y2JZX6JB.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// ../api/src/ads-meta/accountHealth.ts
+var ACCOUNT_STATUS = {
+  1: "ACTIVE",
+  2: "DISABLED",
+  3: "UNSETTLED",
+  7: "PENDING_RISK_REVIEW",
+  8: "PENDING_SETTLEMENT",
+  9: "IN_GRACE_PERIOD",
+  100: "PENDING_CLOSURE",
+  101: "CLOSED",
+  201: "ANY_ACTIVE",
+  202: "ANY_CLOSED"
+};
+var DISABLE_REASON = {
+  1: "ads integrity policy",
+  2: "ads IP review",
+  3: "payment risk",
+  4: "gray account shut down",
+  5: "ads AFC review",
+  6: "business integrity review",
+  7: "permanently closed",
+  8: "unused reseller account",
+  9: "unused account",
+  10: "umbrella ad account",
+  11: "Business Manager integrity policy",
+  12: "misrepresented ad account",
+  13: "legal entity de-share",
+  14: "thread review",
+  15: "compromised ad account"
+};
+var DELIVERS_ANYWAY = /* @__PURE__ */ new Set([1, 9]);
+function statusBlocker(account) {
+  const status = account.account_status;
+  if (status === void 0 || status === 1) return void 0;
+  const name = ACCOUNT_STATUS[status] ?? `status ${status}`;
+  const reason = account.disable_reason ? DISABLE_REASON[account.disable_reason] : void 0;
+  const why = reason ? ` (${reason})` : "";
+  if (DELIVERS_ANYWAY.has(status)) {
+    return `the ad account is ${name}${why}: a payment failed and Meta stops delivery when the grace period ends \u2014 the account owner settles it in Meta Billing`;
+  }
+  return `the ad account is ${name}${why}, so nothing on it delivers \u2014 only the account owner can resolve that with Meta (Account Quality / Billing)`;
+}
+function metaAccountDeliveryBlockers(account) {
+  const blockers = [];
+  const status = statusBlocker(account);
+  if (status) blockers.push(status);
+  const hasFunding = Boolean(account.funding_source || account.funding_source_details?.id);
+  if (!hasFunding && !account.is_prepay_account) {
+    blockers.push(
+      "the ad account has no payment method, so Meta accepts its ads but delivers none (they wait in PENDING_BILLING_INFO) \u2014 the account owner adds one in Meta Billing"
+    );
+  }
+  if (spendCapReached(account)) {
+    blockers.push(
+      "the ad account has reached its spending limit, so Meta stops delivering every ad on it \u2014 an admin raises or removes the limit in Meta Billing \u2192 Payment settings, or Baker can change it as part of a chat"
+    );
+  }
+  return blockers;
+}
+function spendCapReached(account) {
+  const cap = Number(account.spend_cap ?? "0");
+  const spent = Number(account.amount_spent ?? "0");
+  return Number.isFinite(cap) && Number.isFinite(spent) && cap > 0 && spent >= cap;
+}
+
+// src/commands/ads/meta/account.ts
+import { defineCommand } from "citty";
+var accountCommand = defineCommand({
+  meta: {
+    name: "account",
+    description: `Show single Meta ad account detail (currency, timezone, balance, business) and whether it can deliver:
+a hint names a disabled account or a missing payment method, which Meta never refuses at publish \u2014 its ads just never run.
+\`bakerPermissions\` says which per-company Meta permissions (leadAds, catalog, pagePosts) are switched on for this
+company and held by the connection; a hint names any that still needs the user to reconnect Meta.
+
+Examples:
+  baker ads meta account --account-id act_123
+  BAKER_META_AD_ACCOUNT_ID=act_123 baker ads meta account`
+  },
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID (act_...)" },
+    "no-cache": NO_CACHE_ARG
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/account", params);
+      const permissionHints = data.bakerPermissions ? accountPermissionHints(data.bakerPermissions) : [];
+      writeJsonEnvelope({ ok: true, data, hints: [...accountDeliveryHints(data), ...permissionHints] });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+function accountDeliveryHints(account) {
+  const blockers = metaAccountDeliveryBlockers(account);
+  if (blockers.length === 0) return ["The account can deliver: it is active and has a payment method."];
+  return [
+    ...blockers.map((blocker) => `Cannot deliver: ${blocker}.`),
+    "Staging still works and publishing still applies the changes, but nothing serves until this is fixed \u2014 tell the user before they publish anything they expect to run."
+  ];
+}
+var PERMISSION_LABEL = {
+  leadAds: "Lead ads (instant forms and their leads)",
+  catalog: "Catalog changes",
+  pagePosts: "Facebook Page posts"
+};
+function accountPermissionHints(permissions) {
+  return Object.keys(PERMISSION_LABEL).filter((key) => permissions[key].reconnectNeeded).map(
+    (key) => `${PERMISSION_LABEL[key]}: switched on for this company, but this Meta connection predates it \u2014 ask the user to reconnect Meta in the dashboard before relying on it.`
+  );
+}
+export {
+  accountCommand,
+  accountDeliveryHints,
+  accountPermissionHints
+};
+//# sourceMappingURL=account-ZY655BIU.js.map