@koda-sl/baker-cli 0.552.0 → 0.554.0

package/dist/chunk-R7XDGNZD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/capabilities/surfaces.ts","../../api/src/capabilities/index.ts","../../api/src/capabilities/op-fields.ts"],"sourcesContent":["/**\n * The marketing surfaces Baker can reach, and — the part that exists nowhere\n * else — what it cannot do on each of them.\n *\n * Every other introspection surface (`baker schema <cmd>`, the family docs)\n * describes what the agent CAN do. An agent that needs to know a capability is\n * absent has, until now, only been able to find out by trying: promising a GA4\n * property merge and then discovering the connection is read-only, or probing\n * four spellings of a conversion-action field that does not exist. Both cost a\n * retraction in front of a client.\n *\n * This module is deliberately thin on prose and heavy on `evidence`. A\n * hand-maintained \"cannot do\" list rots the same way the Tag Manager built-in\n * trigger whitelist in this repo rotted down to one entry, so each limit carries\n * a machine-checkable claim about the code that makes it true, and\n * `packages/backend/convex/capabilities/coverage.test.ts` fails when a claim\n * stops holding — when the scope is finally requested, when the op ships, when\n * the guard is renamed away. `asserted` is the escape hatch for the handful of\n * facts that live outside this repo entirely, and it has to say why.\n */\n\nexport const CAPABILITY_SURFACES = [\n  \"google-ads\",\n  \"meta-ads\",\n  \"linkedin-ads\",\n  \"x-ads\",\n  \"chatgpt-ads\",\n  \"tag-manager\",\n  \"ga4\",\n  \"gsc\",\n  \"shopify\",\n] as const;\nexport type CapabilitySurfaceId = (typeof CAPABILITY_SURFACES)[number];\n\n/**\n * How a change on this surface reaches the outside world.\n *  - `staged-live`       — staged during the chat and applied against the real\n *                          ad account at publish. The per-company write flags\n *                          that could once make this simulated are retired, so\n *                          a completed chat spends the client's money.\n *  - `staged-immediate`  — staged during the chat and applied at publish for\n *                          real, every time. Tag Manager: completing the chat\n *                          changes the user's production container.\n *  - `read-only`         — nothing here writes.\n *\n * The first two split on consequence, not on certainty: both always apply, but\n * one costs ad spend and the other cuts a container version, and the agent has\n * to tell the user which.\n */\nexport type CapabilityWritePath = \"staged-live\" | \"staged-immediate\" | \"read-only\";\n\nexport interface CapabilitySurfaceSpec {\n  id: CapabilitySurfaceId;\n  /** How the user names it. */\n  label: string;\n  /** The `oauthProviders.type` this surface connects through; `chatgpt-ads` connects with a pasted key instead. */\n  provider: string;\n  /** What the user picks when connecting: \"ad account\", \"property\", \"container\". */\n  resourceNoun: string;\n  writePath: CapabilityWritePath;\n  /**\n   * OAuth scopes that would grant writes. Access is derived by intersecting these\n   * with the scopes the app actually requests — which is why \"GA4 is read-only\"\n   * is a fact about the connection, not a sentence someone typed.\n   */\n  writeScopes: string[];\n  /** Where to look next on this surface. */\n  commands: string;\n  /**\n   * How the company connects. Absent is an OAuth grant, whose scopes decide\n   * access. `api-key` is a pasted key that reaches one account whole, so the\n   * write path alone decides it.\n   */\n  connectsWith?: \"api-key\";\n}\n\nexport const CAPABILITY_SURFACE_SPECS: Readonly<Record<CapabilitySurfaceId, CapabilitySurfaceSpec>> = {\n  \"google-ads\": {\n    id: \"google-ads\",\n    label: \"Google Ads\",\n    provider: \"google-ads\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    writeScopes: [\"https://www.googleapis.com/auth/adwords\"],\n    commands: \"baker ads google\",\n  },\n  \"meta-ads\": {\n    id: \"meta-ads\",\n    label: \"Meta Ads\",\n    provider: \"meta\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    writeScopes: [\"ads_management\"],\n    commands: \"baker ads meta\",\n  },\n  \"linkedin-ads\": {\n    id: \"linkedin-ads\",\n    label: \"LinkedIn Ads\",\n    provider: \"linkedin\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    writeScopes: [\"rw_ads\"],\n    commands: \"baker ads linkedin\",\n  },\n  \"x-ads\": {\n    id: \"x-ads\",\n    label: \"X Ads\",\n    provider: \"x-ads\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    /**\n     * Empty on purpose, and the one surface where that does NOT mean read-only.\n     * X Ads authenticates with OAuth 1.0a, which has no scope strings at all —\n     * write access is granted to the *app* by X's Ads API access review, not\n     * per connection. There is therefore no scope to check, and inventing one\n     * would make `scopeBlockers` refuse every X write for a permission that\n     * does not exist.\n     */\n    writeScopes: [],\n    commands: \"baker ads x\",\n  },\n  \"chatgpt-ads\": {\n    id: \"chatgpt-ads\",\n    label: \"ChatGPT Ads\",\n    // Connected with the client's own Ads API key (`chatgptAdsConnections`), not an OAuth grant.\n    provider: \"chatgpt-ads\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    /**\n     * Empty because the pasted key has no scopes: it reaches its one account\n     * whole. When OpenAI approves Baker's OAuth app this becomes\n     * `ads.admin.all.write` and `connectsWith` goes away.\n     */\n    writeScopes: [],\n    commands: \"baker ads chatgpt\",\n    connectsWith: \"api-key\",\n  },\n  \"tag-manager\": {\n    id: \"tag-manager\",\n    label: \"Tag Manager\",\n    provider: \"google-tag-manager\",\n    resourceNoun: \"container\",\n    writePath: \"staged-immediate\",\n    writeScopes: [\n      \"https://www.googleapis.com/auth/tagmanager.edit.containers\",\n      \"https://www.googleapis.com/auth/tagmanager.edit.containerversions\",\n      \"https://www.googleapis.com/auth/tagmanager.publish\",\n    ],\n    commands: \"baker tag-manager\",\n  },\n  ga4: {\n    id: \"ga4\",\n    label: \"Google Analytics 4\",\n    provider: \"google-analytics\",\n    resourceNoun: \"property\",\n    // Like Tag Manager: staged during the chat, applied for real at publish,\n    // every time. A connection made before writes existed is\n    // read-only until it is reconnected, and `access` does NOT say so — it\n    // reports what the Baker app asks Google for, which is now app-wide\n    // read-write. The per-company signal is `scopeBlockers`, which compares\n    // `writeScopes` against the scopes that connection actually recorded.\n    writePath: \"staged-immediate\",\n    writeScopes: [\"https://www.googleapis.com/auth/analytics.edit\"],\n    commands: \"baker ga4\",\n  },\n  gsc: {\n    id: \"gsc\",\n    label: \"Search Console\",\n    provider: \"google-search-console\",\n    resourceNoun: \"site\",\n    writePath: \"read-only\",\n    writeScopes: [\"https://www.googleapis.com/auth/webmasters\"],\n    commands: \"baker gsc\",\n  },\n  shopify: {\n    id: \"shopify\",\n    label: \"Shopify store\",\n    provider: \"shopify\",\n    resourceNoun: \"store\",\n    // Staged during the chat and applied to the real store when it completes,\n    // every time; each applied change can be put back by another publish\n    // (`baker shopify undo`). The write permissions are optional scopes the\n    // store grants when a change first needs one, so `scopeBlockers` is the\n    // per-company signal.\n    writePath: \"staged-immediate\",\n    writeScopes: [\n      \"write_products\",\n      \"write_publications\",\n      \"write_discounts\",\n      \"write_online_store_navigation\",\n      \"write_marketing_events\",\n    ],\n    commands: \"baker shopify\",\n  },\n};\n\n/**\n * Why a capability is missing. The distinction is what decides what the agent\n * tells the user, so it is part of the contract rather than left to prose:\n *  - `not_built`        — the platform allows it, Baker has not built it. It may\n *                         be possible by hand in the platform's own interface.\n *  - `provider_forbids` — the platform rejects it however it is asked. Nobody can\n *                         do it, so do not hand the user a manual route.\n *  - `no_permission`    — the connection was never granted the access. Reading\n *                         works, changing does not; it is manual work today.\n */\nexport type CapabilityLimitCause = \"not_built\" | \"provider_forbids\" | \"no_permission\";\n\n/**\n * The checkable claim behind a limit. `coverage.test.ts` re-derives each one.\n */\nexport type CapabilityLimitEvidence =\n  /** The app never requests this OAuth scope, so nothing can write here. */\n  | { kind: \"scope\"; scope: string }\n  /** No staged op with these kinds exists, so there is nothing to stage. */\n  | { kind: \"noOpKind\"; kinds: string[] }\n  /** A field on a staged op does not accept this value. */\n  | { kind: \"noChoice\"; opKind: string; field: string; value: string }\n  /** A stage-time guard refuses it before anything is spent. */\n  | { kind: \"guard\"; module: string; symbol: string }\n  /** Nothing in this repository encodes it; the note says why. */\n  | { kind: \"asserted\"; note: string };\n\nexport interface CapabilityLimit {\n  surface: CapabilitySurfaceId;\n  /** What an agent would set out to do, in the words it would use. */\n  capability: string;\n  cause: CapabilityLimitCause;\n  /** Why it cannot happen and what to do instead. Agent-facing, plain English. */\n  detail: string;\n  evidence: CapabilityLimitEvidence;\n}\n\n/**\n * Ordered by how often getting it wrong has cost something. Keep entries to\n * things an agent would plausibly promise a client before checking.\n */\nexport const CAPABILITY_LIMITS: readonly CapabilityLimit[] = [\n  {\n    surface: \"shopify\",\n    capability: \"Edit the store's theme files — templates, sections, the theme's code or its stylesheet\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Shopify only lets an app write theme files with an exemption it grants case by case, and editing a merchant's theme breaks the App Store's rules for an app like Baker. Say exactly what to change and where (Online Store → Themes → Customize), and carry on with the rest of the job.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"Shopify's rule, not this repository's: `write_themes` needs Shopify's exemption and App Store requirement 5.1.1 forbids theme edits by an app of this kind. The app's TOML declares no `write_themes` (scopes.test.ts holds the backend's list equal to it).\",\n    },\n  },\n  {\n    surface: \"shopify\",\n    capability: \"Create or delete products, change stock levels, or change whether a product is published\",\n    cause: \"not_built\",\n    detail:\n      \"Baker changes products' copy, SEO, tags, type, options' SKU, barcode, weight and price, custom fields, collections, discount codes, redirects and its own campaigns in Shopify Marketing. Making or removing a product, its stock and its status are the merchant's, in Shopify admin; say what to do there and carry on.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\"shopify.product.create\", \"shopify.product.delete\", \"shopify.inventory.set\", \"shopify.product.publish\"],\n    },\n  },\n  {\n    surface: \"shopify\",\n    capability: \"Make a discount code for named customers or a customer segment\",\n    cause: \"not_built\",\n    detail:\n      \"Every discount code Baker creates is for everyone who has the code. A code for named customers or a segment is made in Shopify admin → Discounts.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\"shopify.discountCode.createForCustomers\", \"shopify.discountAutomatic.create\"],\n    },\n  },\n  {\n    surface: \"shopify\",\n    capability: \"Make a collection whose products join by rules (a tag, a price, a type), or delete one\",\n    cause: \"not_built\",\n    detail:\n      \"Baker makes collections of hand-picked products and adds or removes products by hand. A collection whose products join by its rules is set up in Shopify admin; Baker refuses to delete one, because undo could not rebuild its rules.\",\n    evidence: { kind: \"guard\", module: \"shopify/writes/collectionRestore.ts\", symbol: \"restorability\" },\n  },\n  {\n    surface: \"ga4\",\n    capability:\n      \"Create, merge or delete a property; create a data stream or change its name, URL or cross-domain settings; change the property's time zone or currency\",\n    cause: \"not_built\",\n    detail:\n      \"Baker configures what a property MEASURES — key events, custom dimensions and metrics, custom events, audiences, the data retention window, a web stream's enhanced measurement (the events GA4 collects on its own) — plus the property's name, industry category and Google Ads link. It does not create or merge properties, create data streams or change a stream's name, URL or cross-domain settings. Time zone and currency are deliberately excluded even though the API allows them: both change how every future day is bucketed without reprocessing history, so a correction puts a step in the middle of every time series the user compares against. Tell the user exactly what to change in the Google Analytics admin screens and carry on with the rest of the job.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\"ga4.dataStream.create\", \"ga4.dataStream.update\", \"ga4.property.create\"],\n    },\n  },\n  {\n    surface: \"ga4\",\n    capability: \"Change who is already in an audience, or build one from a sequence of steps\",\n    cause: \"provider_forbids\",\n    detail:\n      \"An audience can be CREATED and ARCHIVED here, and its name and description changed. Everything that defines who is in it — the conditions, the membership window, the exclusion mode — is marked Immutable by Google and cannot be edited on an audience that exists, however it is asked. Fixing a definition therefore means archiving the audience and creating a replacement, which does NOT carry the users the first one gathered. Say that before staging the archive. Sequence-based audiences (`sequenceFilter`) are not offered: they are the easiest shape in this API to get subtly wrong and the mistake is permanent, so build them by hand in Google Analytics if one is genuinely needed.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"The immutability is Google's, declared in the Admin API v1alpha `Audience` resource (`filter_clauses`, `membership_duration_days` and `exclusion_duration_mode` are all marked Immutable) — no code in this repository can be read to confirm a rule the provider enforces. What this repo does hold is the consequence: `GA4_IMMUTABLE_FIELDS.audience` in `packages/api/src/ga4/ops.ts` drives the refusal, and `ga4.test.ts` pins that an update carrying one of those fields is rejected with the archive-and-recreate wording rather than a zod key error.\",\n    },\n  },\n  {\n    surface: \"ga4\",\n    capability: \"Try a Google Analytics configuration change without it taking effect\",\n    cause: \"not_built\",\n    detail:\n      \"Google Analytics changes always apply to the real property: staged changes apply when the chat completes, and an applied change is in effect immediately — there is no version to publish afterwards and no undo. The user reviewing the Analytics tab and completing the chat is the review, so agree the changes with them before you complete it.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"An absence: the GA4 executor has no simulated branch and GA4 drafts have no `mode` column, and no test can assert the absence of a mode that was never modelled. The nearest positive check is that the three ad surfaces do carry one — a `mode` column on their drafts and an `executeSimulated` branch in each executor — which the `staged-live` vs `staged-immediate` write paths already encode. Their per-company write gates are retired, so every ad draft is stamped `live`; the branch survives only for drafts published while the gates existed.\",\n    },\n  },\n  {\n    surface: \"gsc\",\n    capability:\n      \"Change anything in Search Console — add or verify a property, submit or delete a sitemap, set a preferred domain\",\n    cause: \"no_permission\",\n    detail:\n      \"Baker's Search Console connection is read-only (webmasters.readonly). `baker gsc sitemaps` lists what is already submitted; it cannot submit one. Hand submission to the user in Search Console and carry on.\",\n    evidence: { kind: \"scope\", scope: \"https://www.googleapis.com/auth/webmasters\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability:\n      \"Change a conversion action that Google itself created — Smart campaign calls and directions, the in-ad lead form's submit, YouTube subscriptions and follow-on views, Floodlight and Search Ads 360 imports, store visits, codeless webpage actions\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google rejects every write against one of its own conversion actions, a rename as flatly as a removal. Baker refuses these at stage time so no publish is spent on them. There is no manual route either — the Google Ads interface will not change them — so do not hand the user one. Leave the action alone and say so.\",\n    evidence: {\n      module: \"ads/google/writes/conversionSafety.ts\",\n      kind: \"guard\",\n      symbol: \"googleOwnedConversionRefusal\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability:\n      \"Switch a demographic dimension — age, gender, parental status, household income — between Targeting and Observation\",\n    cause: \"not_built\",\n    detail:\n      \"`baker ads google audiences targeting` sets the AUDIENCE dimension only. The demographic rows are read before every write and sent back exactly as they were, so nothing is lost — but changing one is manual work in the Google Ads interface. Say which one to change and where, and carry on with the rest of the job.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.targetingSetting.set\", field: \"audience\", value: \"AGE_RANGE\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Hide a conversion action (status HIDDEN)\",\n    cause: \"provider_forbids\",\n    detail:\n      'Google denies HIDDEN on every conversion-action write (\"the field\\'s value is on a deny-list for this field\"), so it is not part of the write contract — even though actions hidden long ago still read back as HIDDEN. To take an action out of automated bidding while it keeps measuring, demote it: `baker ads google conversions update <id> --no-primary`. To stop it counting, set status REMOVED.',\n    evidence: { kind: \"noChoice\", opKind: \"google.conversionAction.update\", field: \"status\", value: \"HIDDEN\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability:\n      \"Build a combined, converters or lookalike audience from an audience or conversion action created in the same chat\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google builds these lists from audiences and conversion actions that already exist in the account; one created in the same publish is not found. Stage and publish the parts first, then build the combined, converters or lookalike audience on their ids in a later chat — and tell the user it takes two publishes.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"Enforced by `existingRefSchema` inside `audienceCreateSchema` (packages/api ops.ts), which no capability check reads; the provider half is live on v25: a logical operand on a list created in the same request was RESOURCE_NOT_FOUND, a basic list over a conversion action created with it INVALID_CONVERSION_TYPE, and lookalike seeds are int64 ids.\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Create a Google Analytics (GA4) conversion action in Google Ads\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google's API cannot create a Google Analytics conversion — they are imported, not created. Make sure the event is a key event in Google Analytics and the property is linked to Google Ads, then ask the user to import it in Google Ads (Goals → Conversions → New conversion action → Import → Google Analytics 4). To measure it with a Google Ads tag instead, stage a WEBPAGE conversion.\",\n    evidence: {\n      kind: \"noChoice\",\n      opKind: \"google.conversionAction.create\",\n      field: \"type\",\n      value: \"GOOGLE_ANALYTICS_4_CUSTOM\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Target the area around the business's own locations (a location group)\",\n    cause: \"not_built\",\n    detail:\n      'A location group targets a radius around the account\\'s location assets, and Baker cannot stage location assets yet — Google refuses a location group on an account without them. Target a radius around an address or a point instead (`criterionType: \"proximity\"` on `campaign-criteria add`), or tell the user to add the business locations in Google Ads; carry on with the rest of the job.',\n    evidence: {\n      kind: \"asserted\",\n      note: 'The refusal is in the shared criterion contract, not a Convex guard: `criterionSpecSchema` in `packages/api/src/ads-google/criteria.ts` answers `criterionType: \"locationGroup\"` with LOCATION_GROUP_MESSAGE, pinned by `criteria.test.ts`. Live on v25 (3865083115, no location assets) every location-group variant was refused — `enable_customer_level_location_asset_set` with \"The error code is not in this version.\", a geo-constant group with `location_group.feed` REQUIRED.',\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Create a Video or Local campaign\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google's API does not create Video campaigns at all (refused for every sub-type and bidding), and Local campaigns were retired into Performance Max. For video on YouTube, stage a Demand Gen campaign with a Demand Gen video ad; for store visits, Performance Max. A Video views or reach campaign is the user's to create in Google Ads — say so, with the settings you recommend. Existing Video campaigns can still be read, paused and edited.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.campaign.create\", field: \"channelType\", value: \"VIDEO\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Create a Smart campaign\",\n    cause: \"not_built\",\n    detail:\n      \"A Smart campaign's business details (phone, website, business profile) are a setting Google refuses to check before publishing (RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY), so Baker cannot stage one it could validate. Stage a Search or Performance Max campaign instead, or hand the Smart campaign to the user in Google Ads and carry on with the rest of the job. Shopping, App, Travel and Hotel campaigns ARE stageable — each with the account link it needs. Existing Smart campaigns can still be read, paused and edited.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.campaign.create\", field: \"channelType\", value: \"SMART\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability:\n      \"Create a campaign of a retired sub-type — Search or Display Express, Gmail, Smart Display, Smart Shopping, Video action, app promotion on Search\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google refuses every one of these on a create. Leave the sub-type out for a standard campaign of the same type; Gmail and Video action now run through Demand Gen, Smart Shopping through Performance Max.\",\n    evidence: {\n      kind: \"noChoice\",\n      opKind: \"google.campaign.create\",\n      field: \"channelSubType\",\n      value: \"DISPLAY_GMAIL_AD\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Set a campaign budget to accelerated delivery\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google still stores a budget set to accelerated delivery, but refuses to attach it to any campaign, so it can never spend. Every budget is staged with standard delivery (Google paces it across the day). If the user wants to spend faster, raise the daily amount instead — and say that is what you did.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.budget.create\", field: \"deliveryMethod\", value: \"ACCELERATED\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Create or edit a call ad (call-only ad)\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google removed the call ad from its API, so nobody can create one or change an existing one through it. To take phone calls from search, stage a responsive search ad and tell the user to add the phone number as a call asset in Google Ads (Baker cannot stage call assets yet). Carry on with the rest of the job.\",\n    evidence: {\n      kind: \"asserted\",\n      note: 'The format sits inside the ad content union, not on a top-level payload field, so no `noChoice` check can see it. `adContentSchema` answers `format: \"call\"` with CALL_AD_RETIRED_MESSAGE (packages/api ops.test.ts pins it); the provider half is v25\\'s `Ad` message having no `call_ad` — a validateOnly request on 3865083115 was refused `Unknown name \"callAd\"` (2026-10-08).',\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Remove a device setting from a campaign once it has one\",\n    cause: \"provider_forbids\",\n    detail:\n      \"A device criterion can be added with `campaign-criteria add` and re-bid afterwards, but Google rejects every removal of one — including a criterion the same account created itself days earlier (observed). So the undo for a bid boost is NOT a removal: it is `baker ads google campaign-criteria update <criterion-resource-name> --bid-modifier 1`, where 0 stops ads serving on that device and 0.1–10.0 bid down or up. Read `campaign_criterion.resource_name` and `campaign_criterion.bid_modifier` (type = DEVICE) first to see which devices the campaign already has. Baker refuses a staged device removal before publish; don't abort the job over it.\",\n    evidence: {\n      kind: \"guard\",\n      module: \"ads/google/writes/stage.ts\",\n      symbol: \"deviceCriterionRemovalRefusal\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Change which conversion action counts calls from ads (account call reporting)\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google's API refuses any write of the account's call conversion action, even the one it already uses. Call reporting itself and whether calls count as conversions ARE stageable (`baker ads google account update --call-reporting --call-conversions`). Hand the action choice to the user: Google Ads → Admin → Account settings → Call reporting. Carry on with the rest of the job.\",\n    evidence: {\n      kind: \"asserted\",\n      note: '`customerUpdateSchema` is strict and carries no callConversionAction, so an op naming it is refused at stage; the provider half: a validateOnly customer update of `call_reporting_setting.call_conversion_action` on 3865083115 — with the live value and with another action — was refused \"The error code is not in this version.\" (v25, 2026-10-08).',\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Put a label on an asset (sitelink, image, callout …)\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google Ads has no labels on assets — its API labels campaigns, ad groups, ads and keywords only, and staging refuses an asset. Label the campaign or ad group that uses the asset, or give the asset a findable name, and carry on with the rest of the job.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.label.attach\", field: \"level\", value: \"asset\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Put a label on the advertiser account itself\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google applies a label to an account only from the manager account above it (CANNOT_ATTACH_NON_MANAGER_LABEL_TO_CUSTOMER, live v25), and Baker works inside the advertiser account. Label the campaigns instead, or tell the user to label the account from their manager account in Google Ads; carry on with the rest of the job.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.label.attach\", field: \"level\", value: \"customer\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Change billing, payment methods, or account-level spend limits\",\n    cause: \"not_built\",\n    detail:\n      \"Nothing that touches money setup is stageable — no op exists for it. Report on spend, then hand billing changes to the user in Google Ads. Account settings that are not money (auto-tagging, the account tracking template and final URL suffix, call reporting, video inventory) ARE stageable: `baker ads google account update`.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\"google.billingSetup.create\", \"google.accountBudget.create\"],\n    },\n  },\n  {\n    surface: \"meta-ads\",\n    capability:\n      \"Push delivery to an ad — dedicate a share of the campaign or ad-set budget to one ad for a set number of days\",\n    cause: \"not_built\",\n    detail:\n      'Meta ships push delivery as an Ads Manager control only: the Marketing API\\'s ad object takes a schedule, a display sequence and tracking, and nothing that dedicates budget to one ad. So nothing can stage it and no publish can apply it — do not offer to switch it on, and never report a starved ad as pushed. Hand the user the click path and the settings you are recommending: Ad level > Ad setup > \"show more settings\" (next to ad scheduling) > \"Help ensure delivery by dedicating a portion of your budget to your ad\", then the percentage of budget and the number of days, for the one ad you name. It needs at least 2 ads in the ad set, and only one ad per ad set should be pushed. Then carry on with the rest of the job.',\n    evidence: { kind: \"noOpKind\", kinds: [\"ad.pushDelivery\"] },\n  },\n  {\n    surface: \"linkedin-ads\",\n    capability: \"Move a live ad to another ad set, or change a live ad set's type, locale, or associated organization\",\n    cause: \"provider_forbids\",\n    detail:\n      \"LinkedIn treats these as create-only: they can be corrected while the change is still staged, but not on something already live. Baker refuses the amend rather than staging a write LinkedIn will reject. Create the replacement instead, and say why.\",\n    evidence: { kind: \"guard\", module: \"ads/linkedin/writes/amend.ts\", symbol: \"rejectedLiveKeys\" },\n  },\n  {\n    surface: \"tag-manager\",\n    capability: \"Create, delete, or move a Tag Manager account, container, or workspace\",\n    cause: \"not_built\",\n    detail:\n      \"Baker works inside the containers the company connected — it changes tags, triggers, variables, folders, built-in variables and container settings, and nothing above that level. Ask the user to create the container in Tag Manager and connect it, then carry on.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\n        \"tagManager.container.create\",\n        \"tagManager.container.delete\",\n        \"tagManager.account.create\",\n        \"tagManager.workspace.create\",\n      ],\n    },\n  },\n  {\n    surface: \"tag-manager\",\n    capability: \"Try a container change without it going live\",\n    cause: \"not_built\",\n    detail:\n      \"Tag Manager changes always apply to the real container: staged changes apply to its working workspace when the chat completes, and a clean run cuts and publishes a container version, which takes them live on the site. Completing the chat is the review, so get the user's agreement before you complete it.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"An absence: the Tag Manager executor has no simulated branch and its drafts have no `mode` column, and no test can assert the absence of a mode that was never modelled. The nearest positive check is that the three ad surfaces do carry one — a `mode` column on their drafts and an `executeSimulated` branch in each executor — which the `staged-live` vs `staged-immediate` write paths already encode. Their per-company write gates are retired, so every ad draft is stamped `live`; the branch survives only for drafts published while the gates existed.\",\n    },\n  },\n];\n","/**\n * Contract for `/api/capabilities` — what Baker can and cannot do for this\n * company, answered before any work starts (`baker capabilities`).\n *\n * Convex `Id<T>` values are plain `z.string()`; this package must not depend on\n * `convex`. Nothing here carries a token, key, or anything a credential could be\n * reconstructed from — the response names accounts and permissions, never\n * secrets.\n */\nimport { z } from \"zod\";\nimport { CAPABILITY_SURFACES } from \"./surfaces\";\n\nexport { describeOpPayload, describeOpUnion, type OpDescription } from \"./op-fields\";\nexport {\n  CAPABILITY_LIMITS,\n  CAPABILITY_SURFACE_SPECS,\n  CAPABILITY_SURFACES,\n  type CapabilityLimit,\n  type CapabilityLimitCause,\n  type CapabilityLimitEvidence,\n  type CapabilitySurfaceId,\n  type CapabilitySurfaceSpec,\n  type CapabilityWritePath,\n} from \"./surfaces\";\n\nexport const capabilitySurfaceSchema = z.enum(CAPABILITY_SURFACES);\n\nexport const capabilitiesRequestSchema = z.object({\n  /** Narrow to one surface. Omit for every surface the company could use. */\n  surface: capabilitySurfaceSchema.optional(),\n  /** Include the field-level contract of every op, not just the entity list. */\n  full: z.boolean().optional(),\n  /**\n   * Who the chat acts as (`BAKER_ACTING_USER_ID`). Adds that person's own\n   * connected tools — they load for this turn, and for nobody else's.\n   */\n  actingUserId: z.string().optional(),\n});\nexport type CapabilitiesRequest = z.infer<typeof capabilitiesRequestSchema>;\n\n/** A connected account, property, site or container. Identity only. */\nexport const capabilityResourceSchema = z.object({\n  id: z.string(),\n  name: z.string().optional(),\n});\nexport type CapabilityResource = z.infer<typeof capabilityResourceSchema>;\n\nexport const capabilityOpSchema = z.object({\n  kind: z.string(),\n  /** True when the op changes something that already exists and must be named. */\n  needsTarget: z.boolean(),\n  required: z.array(z.string()),\n  optional: z.array(z.string()),\n  /** Field → the values it accepts, for fields that take a fixed set. */\n  choices: z.record(z.string(), z.array(z.string())),\n  /** False when the platform accepts fields beyond the listed ones. */\n  fieldsAreComplete: z.boolean(),\n});\nexport type CapabilityOp = z.infer<typeof capabilityOpSchema>;\n\nexport const capabilityLimitViewSchema = z.object({\n  capability: z.string(),\n  cause: z.enum([\"not_built\", \"provider_forbids\", \"no_permission\"]),\n  detail: z.string(),\n});\nexport type CapabilityLimitView = z.infer<typeof capabilityLimitViewSchema>;\n\n/**\n * `live` — writes reach the real platform at publish.\n * `applies-at-publish` — publishing changes the real thing, with no version step after.\n * `none` — this surface does not write.\n *\n * There is no `simulated`: the per-company gates that produced it on Google,\n * Meta and LinkedIn are all retired, so no surface can report a write that\n * touches nothing. Leaving the value in the contract would keep alive the one\n * sentence this report exists to prevent — \"your ads are only a preview\".\n */\nexport const capabilityWriteModeSchema = z.enum([\"live\", \"applies-at-publish\", \"none\"]);\nexport type CapabilityWriteMode = z.infer<typeof capabilityWriteModeSchema>;\n\nexport const capabilitySurfaceReportSchema = z.object({\n  surface: capabilitySurfaceSchema,\n  label: z.string(),\n  connected: z.boolean(),\n  /** What the user picked when connecting. Empty when nothing is selected yet. */\n  resources: z.array(capabilityResourceSchema),\n  access: z.enum([\"read-write\", \"read-only\", \"not-connected\"]),\n  writeMode: capabilityWriteModeSchema,\n  /** One sentence about the write mode, safe to repeat to the user. */\n  writeModeNote: z.string(),\n  /** Entities this surface can change at all, e.g. \"campaign\", \"keyword\". */\n  writableEntities: z.array(z.string()),\n  /** Things wrong with the connection itself: needs reconnecting, missing a permission. */\n  blockers: z.array(z.string()),\n  /** What cannot be done here, and why. */\n  limits: z.array(capabilityLimitViewSchema),\n  /** The per-op contract. Present when one surface was asked for, or with `full`. */\n  ops: z.array(capabilityOpSchema).optional(),\n  /** Where to look next: `baker ads google`, `baker ga4`, … */\n  commands: z.string(),\n});\nexport type CapabilitySurfaceReport = z.infer<typeof capabilitySurfaceReportSchema>;\n\n/**\n * A source that is available to this company but is not one of the seven\n * marketing surfaces above.\n *\n * These exist because \"what do I have?\" had no single answer, and the gap was\n * not academic: Microsoft Clarity arrives over MCP and HubSpot is read through\n * the CLI, so neither appears in `surfaces` — and an agent that checked only\n * this command concluded it had no Clarity while Clarity was sitting in its own\n * tool list. That is the source most likely to change what it decides.\n *\n * Deliberately NOT modelled as a surface. A surface carries `ops`,\n * `writableEntities` and a write mode, all of which describe a staged-write\n * contract Baker owns. An MCP toolkit has none of that — Baker did not define\n * its tools and cannot enumerate their fields — so filing one under `surfaces`\n * would mean either lying about the contract or leaving four fields empty on\n * every row and inviting the reader to wonder which.\n */\nexport const capabilityToolSchema = z.object({\n  /** `microsoft_clarity`, `hubspot`, or the name the user gave a custom server. */\n  key: z.string(),\n  label: z.string(),\n  /** `mcp` — tools in the agent's own list. `platform` — signed in, read through the CLI. */\n  kind: z.enum([\"mcp\", \"platform\"]),\n  /** How to actually reach it, in one phrase the agent can act on. */\n  reach: z.string(),\n  /**\n   * Whether it can be used right now.\n   *\n   * A connection that exists and is expired is worse than one that is absent:\n   * it reads as available and fails at the moment it is needed, which on an\n   * unattended run is a report with a hole in it and no explanation.\n   */\n  ready: z.boolean(),\n  /** Why it is not ready, or what it is for. Absent when neither needs saying. */\n  note: z.string().optional(),\n});\nexport type CapabilityTool = z.infer<typeof capabilityToolSchema>;\n\nexport const capabilitiesResponseSchema = z.object({\n  ok: z.literal(true),\n  data: z.object({\n    surfaces: z.array(capabilitySurfaceReportSchema),\n    /**\n     * Everything else this company can reach. Shared connections only —\n     * a teammate's private per-user connection belongs to whoever started the\n     * session and is visible in the agent's own tool list, not here.\n     */\n    tools: z.array(capabilityToolSchema),\n  }),\n});\nexport type CapabilitiesResponse = z.infer<typeof capabilitiesResponseSchema>;\n","import { z } from \"zod\";\n\n/**\n * What each staged write op actually accepts, read off the contract itself.\n *\n * The alternative is a hand-written table of \"fields you can set\", and the\n * repository already knows how that ends: a list nobody re-reads drifts from the\n * schema, and the agent trusts it until a publish fails. Every fact here is\n * derived from the same `z.discriminatedUnion` the CLI preflights against and\n * the backend parses with, so it cannot disagree with what a write will accept.\n *\n * Zod internals are read through `_zod.def` on purpose: zod 4 exposes no public\n * introspection API, and the alternative (parsing probe payloads) can only ever\n * tell you a field was rejected, never that it exists. `unwrapObject` and the\n * `optional`/`default` handling are the whole surface of that coupling — if zod\n * changes it, `op-fields.test.ts` fails on the real shipped unions, not just on\n * toy fixtures, which is why those two cases are in the test.\n */\n\n/**\n * A payload field's own metadata never crosses this boundary — only names and,\n * where the field takes a fixed set, its accepted values.\n */\nexport interface OpDescription {\n  /** The op kind, e.g. `google.conversionAction.update`. */\n  kind: string;\n  /** True when the op changes an entity that already exists and must be named. */\n  needsTarget: boolean;\n  /** Payload fields that must be supplied. */\n  required: string[];\n  /** Payload fields that may be supplied (a defaulted field counts — it can be omitted). */\n  optional: string[];\n  /** Field name → the values it accepts, for fields that take a fixed set. */\n  choices: Record<string, string[]>;\n  /**\n   * False when the platform accepts fields beyond the declared ones — Tag Manager\n   * payloads pass unknown keys straight through to Google, so \"not listed here\"\n   * does not mean \"not accepted\" there.\n   */\n  fieldsAreComplete: boolean;\n}\n\ninterface ZodDef {\n  type?: string;\n  shape?: Record<string, unknown>;\n  options?: unknown[];\n  values?: unknown[];\n  entries?: Record<string, unknown>;\n  innerType?: unknown;\n  catchall?: unknown;\n}\n\nfunction def(schema: unknown): ZodDef | undefined {\n  if (typeof schema !== \"object\" || schema === null) return undefined;\n  const internals = (schema as { _zod?: { def?: ZodDef } })._zod;\n  return internals?.def;\n}\n\n/** Peel `.optional()` / `.default()` / `.nullable()` wrappers off a field. */\nfunction unwrap(schema: unknown): { inner: unknown; omittable: boolean } {\n  let current = schema;\n  let omittable = false;\n  for (let depth = 0; depth < 8; depth += 1) {\n    const d = def(current);\n    if (!d) break;\n    if (d.type === \"optional\" || d.type === \"default\" || d.type === \"prefault\") {\n      omittable = true;\n      current = d.innerType;\n      continue;\n    }\n    if (d.type === \"nullable\" || d.type === \"readonly\") {\n      current = d.innerType;\n      continue;\n    }\n    break;\n  }\n  return { inner: current, omittable };\n}\n\n/**\n * The object underneath a payload schema, or undefined when the payload is not\n * an object at all (a discriminated union of formats, say). A cross-field rule\n * added with `.refine()` keeps the shape in zod 4, but `.innerType` is followed\n * anyway so a wrapped schema degrades to the object rather than to nothing.\n */\nfunction unwrapObject(schema: unknown): ZodDef | undefined {\n  let current = schema;\n  for (let depth = 0; depth < 8; depth += 1) {\n    const d = def(current);\n    if (!d) return undefined;\n    if (d.shape) return d;\n    if (d.innerType === undefined) return undefined;\n    current = d.innerType;\n  }\n  return undefined;\n}\n\nfunction literalValue(schema: unknown): string | undefined {\n  const values = def(schema)?.values;\n  const first = values?.[0];\n  return typeof first === \"string\" ? first : undefined;\n}\n\nfunction acceptedValues(schema: unknown): string[] | undefined {\n  const d = def(schema);\n  if (d?.type === \"enum\" && d.entries) return Object.keys(d.entries);\n  if (d?.type === \"literal\" && d.values) {\n    const values = d.values.filter((value): value is string => typeof value === \"string\");\n    return values.length > 0 ? values : undefined;\n  }\n  return undefined;\n}\n\n/** Anything with `.options` — the shipped op unions, or a fixture built in a test. */\ninterface DiscriminatedUnionLike {\n  options: readonly unknown[];\n}\n\ntype PayloadFields = Pick<OpDescription, \"required\" | \"optional\" | \"choices\">;\n\nfunction payloadFields(payload: ZodDef | undefined): PayloadFields {\n  const required: string[] = [];\n  const optional: string[] = [];\n  const choices: Record<string, string[]> = {};\n  for (const [name, field] of Object.entries(payload?.shape ?? {})) {\n    const { inner, omittable } = unwrap(field);\n    (omittable ? optional : required).push(name);\n    const values = acceptedValues(inner);\n    if (values) choices[name] = values;\n  }\n  return { required, optional, choices };\n}\n\n/**\n * True when a key outside the shape cannot get through: stripped (plain object) or refused (a\n * strict object's catchall is `never`). A `looseObject` / `.catchall(z.unknown())` passes it on.\n */\nfunction refusesUnknownKeys(payload: ZodDef): boolean {\n  return payload.catchall === undefined || def(payload.catchall)?.type === \"never\";\n}\n\nfunction describeOption(option: unknown): OpDescription | undefined {\n  const shape = def(option)?.shape;\n  if (!shape) return undefined;\n  const kind = literalValue(shape.kind);\n  if (kind === undefined) return undefined;\n  const payload = unwrapObject(shape.payload);\n  return {\n    kind,\n    needsTarget: shape.target !== undefined,\n    ...payloadFields(payload),\n    fieldsAreComplete: shape.payload === undefined || (payload !== undefined && refusesUnknownKeys(payload)),\n  };\n}\n\n/**\n * One description per member of a staged-write op union, in declaration order.\n */\nexport function describeOpUnion(union: DiscriminatedUnionLike): OpDescription[] {\n  const options = def(union)?.options ?? union.options;\n  return options.map(describeOption).filter((entry): entry is OpDescription => entry !== undefined);\n}\n\n/** The slice of JSON Schema `z.toJSONSchema` writes that a payload's shape is read from. */\ninterface JsonSchema {\n  type?: string | string[];\n  const?: unknown;\n  enum?: unknown[];\n  anyOf?: JsonSchema[];\n  oneOf?: JsonSchema[];\n  properties?: Record<string, JsonSchema>;\n  required?: string[];\n  items?: JsonSchema;\n  prefixItems?: JsonSchema[];\n  additionalProperties?: boolean | JsonSchema;\n  $ref?: string;\n  $defs?: Record<string, JsonSchema>;\n}\n\n/**\n * A shape that contains itself (a Tag Manager parameter holds a list of parameters) arrives as a\n * `$ref` into `$defs`: it is spelled out the first time and written `…` inside itself.\n */\ninterface Rendering {\n  defs: Record<string, JsonSchema>;\n  expanding: ReadonlySet<string>;\n  indent: string;\n}\n\nfunction isObjectSchema(schema: JsonSchema): boolean {\n  return schema.properties !== undefined;\n}\n\n/** Members of a union of objects go one per line, so a reader scans the variants, not a wall. */\nfunction unionText(members: JsonSchema[], at: Rendering): string {\n  const texts = [...new Set(members.map((member) => shapeText(member, { ...at, indent: `${at.indent}  ` })))];\n  if (!members.every(isObjectSchema) || texts.length < 2) return texts.join(\" | \");\n  return texts.map((text, index) => (index === 0 ? text : `\\n${at.indent}| ${text}`)).join(\"\");\n}\n\nfunction objectText(schema: JsonSchema, at: Rendering): string {\n  const required = new Set(schema.required ?? []);\n  const fields = Object.entries(schema.properties ?? {}).map(([name, field]) => {\n    const value = shapeText(field, at);\n    const optional = required.has(name) ? \"\" : \"?\";\n    return value.startsWith(\"\\n\") || !value.includes(\"\\n\")\n      ? `${name}${optional}: ${value}`\n      : `${name}${optional}:\\n${at.indent}  ${value}`;\n  });\n  return fields.length === 0 ? \"{}\" : `{ ${fields.join(\", \")} }`;\n}\n\nfunction typeText(type: string, schema: JsonSchema, at: Rendering): string {\n  if (type === \"array\" && schema.prefixItems) {\n    return `[${schema.prefixItems.map((item) => shapeText(item, at)).join(\", \")}]`;\n  }\n  if (type === \"array\") {\n    const item = schema.items ? shapeText(schema.items, at) : \"unknown\";\n    return item.includes(\" \") ? `(${item})[]` : `${item}[]`;\n  }\n  if (type === \"object\") {\n    const values =\n      typeof schema.additionalProperties === \"object\" ? shapeText(schema.additionalProperties, at) : \"unknown\";\n    return `{ [key: string]: ${values} }`;\n  }\n  return type === \"integer\" ? \"number\" : type;\n}\n\n/** A TypeScript-like one-glance rendering: names, nesting, literals and enums — no patterns or bounds. */\nfunction shapeText(schema: JsonSchema, at: Rendering): string {\n  if (schema.$ref !== undefined) {\n    const name = schema.$ref.replace(\"#/$defs/\", \"\");\n    const target = at.defs[name];\n    if (target === undefined || at.expanding.has(name)) return \"…\";\n    return shapeText(target, { ...at, expanding: new Set([...at.expanding, name]) });\n  }\n  if (schema.const !== undefined) return JSON.stringify(schema.const);\n  if (schema.enum) return schema.enum.map((value) => JSON.stringify(value)).join(\" | \");\n  const members = schema.oneOf ?? schema.anyOf;\n  if (members) return unionText(members, at);\n  if (isObjectSchema(schema)) return objectText(schema, at);\n  const types = Array.isArray(schema.type) ? schema.type : [schema.type ?? \"unknown\"];\n  return types.map((type) => typeText(type, schema, at)).join(\" | \");\n}\n\n/**\n * The payload an op kind takes, as one readable shape: every field, nested objects and each member\n * of a union with its own fields, the literals and enum values each accepts. Read off the contract\n * with zod's own `toJSONSchema`, so it is the shape `--file` is parsed with — undefined for a kind\n * the union does not hold, or one whose op carries no payload.\n */\nexport function describeOpPayload(union: DiscriminatedUnionLike, kind: string): string | undefined {\n  const options = def(union)?.options ?? union.options;\n  const option = options.find((candidate) => literalValue(def(candidate)?.shape?.kind) === kind);\n  const payload = def(option)?.shape?.payload;\n  if (payload === undefined) return undefined;\n  const schema = z.toJSONSchema(payload as z.ZodType, { io: \"input\", unrepresentable: \"any\" }) as JsonSchema;\n  return shapeText(schema, { defs: schema.$defs ?? {}, expanding: new Set(), indent: \"\" });\n}\n\n/** The close of a refusal that names the payload the op takes, or nothing when there is none to name. */\nexport function payloadShapeSentence(union: DiscriminatedUnionLike, kind: string): string {\n  const shape = describeOpPayload(union, kind);\n  return shape === undefined ? \"\" : `. ${kind} takes this payload (a field marked ? may be left out):\\n${shape}`;\n}\n"],"mappings":"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","names":["z","z"]}

package/dist/chunk-RHNNFCRY.js

@@ -0,0 +1,494 @@
+import {
+  DEFAULT_SUBSETS,
+  FONT_PROVIDERS,
+  checkFontRequests,
+  fontFileName,
+  fontsourceCatalogue,
+  fontsourceFamilies,
+  googleFontRequests,
+  missingFontFiles,
+  planFontAdoption,
+  renderFontFaceCss,
+  resolveBrandFaces,
+  resolveFetchStyles,
+  resolveFetchSubsets,
+  resolveFetchWeights,
+  selfHostedStyles,
+  selfHostedSubsets,
+  selfHostedWeights,
+  stripFontFaceBlocks,
+  suggestFamilies,
+  unresolvedBrandFamilies,
+  upsertFontFaceCss
+} from "./chunk-OKXLOLEV.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+
+// src/commands/brand/fonts.ts
+import { mkdir, readdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+var GLOBAL_CSS = path.join("src", "styles", "global.css");
+var FONTS_DIR = path.join("src", "brand", "fonts");
+var DEFAULT_SUBSETS_LABEL = DEFAULT_SUBSETS.join(",");
+var BROWSER_UA = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 Chrome/120.0 Safari/537.36";
+registerSchema({
+  command: "brand.fonts.check",
+  description: "Start here when a brand's fonts are 'confirmed' but nobody verified it. Fails if any --font-* family in src/styles/global.css has nothing loading it (no @font-face, no Google import) \u2014 the silent fallback that also fails the client's verify \u2014 then asks Google Fonts what it ACTUALLY serves for every family/weight the stylesheet requests.",
+  args: {}
+});
+registerSchema({
+  command: "brand.fonts.adopt",
+  description: "Move brand faces a page already self-hosts into src/styles/global.css, so every page loads them rather than only the page that declared them. Use when `check` reports a family as not loaded but its files are already in src/brand/fonts/. Never downloads: re-fetching would hand that page a different build of the same face.",
+  args: {}
+});
+registerSchema({
+  command: "brand.fonts.fetch",
+  description: "Download a font into src/brand/fonts/ so the brand stops depending on a third party at page load, and write its @font-face into src/styles/global.css above @theme. Resolves against Google Fonts first, then Fontsource \u2014 which carries ~2000 open-licence families Google does not, so a name Google 400s is often still fetchable. Idempotent: re-running replaces that family's faces rather than stacking duplicates.",
+  args: {
+    family: { type: "string", description: 'Font family, e.g. "DM Sans"', required: true },
+    weights: {
+      type: "string",
+      description: "Comma-separated weights (default: the weights global.css already requests or self-hosts, else 400)",
+      required: false
+    },
+    subsets: {
+      type: "string",
+      description: `Comma-separated unicode subsets (default: the subsets global.css already self-hosts, else ${DEFAULT_SUBSETS_LABEL})`,
+      required: false
+    },
+    italic: {
+      type: "boolean",
+      description: "Also self-host the family's italic faces. On automatically when global.css already loads one, so a re-fetch never strands it.",
+      required: false
+    }
+  }
+});
+function fail(code, message, fix) {
+  writeJson({ ok: false, error: { code, message, ...fix ? { fix } : {} } });
+  process.exit(2);
+}
+var REQUEST_TIMEOUT_MS = 15e3;
+async function fetchJson(url) {
+  const res = await fetch(url, {
+    headers: { "User-Agent": BROWSER_UA },
+    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+  });
+  if (res.status === 404) return null;
+  if (!res.ok) throw new Error(`Fontsource answered ${res.status}`);
+  return await res.json();
+}
+async function lookupGoogleCss(url) {
+  try {
+    const res = await fetch(url, {
+      headers: { "User-Agent": BROWSER_UA },
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+    if (res.ok) return { status: "served", css: await res.text() };
+    return { status: res.status === 400 ? "absent" : "unreachable" };
+  } catch {
+    return { status: "unreachable" };
+  }
+}
+var fetchGoogleCss = async (url) => {
+  const got = await lookupGoogleCss(url);
+  return got.status === "served" ? got.css : null;
+};
+var WIRING_HINT = {
+  written: (family) => `Wrote the @font-face for "${family}" into ${GLOBAL_CSS}, above @theme. Remove "${family}" from the Google @import if one is still there, so the page stops fetching it at load.`,
+  // Told apart from "no stylesheet" on purpose: they used to share one hint, so
+  // an idempotent re-run instructed the agent to paste a block that was already
+  // in the file, and doing as it was told duplicated the face.
+  "already-wired": (family) => `${GLOBAL_CSS} already loads exactly these faces for "${family}" \u2014 nothing to change.`,
+  "no-stylesheet": () => `No ${GLOBAL_CSS} to write to \u2014 paste the \`fontFace\` block above the @theme block once the stylesheet exists, or the files just downloaded will never load.`
+};
+var PROVIDER_DEPS = { lookupGoogleCss, fetchJson };
+var PROVIDER_LABEL = { google: "Google Fonts", fontsource: "Fontsource" };
+function italicHints(family, wantedStyles, availableStyles, downloadedStyles, provider) {
+  const wanted = wantedStyles.includes("italic");
+  const available = availableStyles.includes("italic");
+  if (wanted && !downloadedStyles.includes("italic")) {
+    return [
+      `NO ITALIC: ${PROVIDER_LABEL[provider]} does not ship an italic for "${family}", so none was written. Drop italic from src/brand/BRAND.md, or the browser will slant the upright face instead.`
+    ];
+  }
+  if (!wanted && available) {
+    return [
+      `${PROVIDER_LABEL[provider]} also ships an italic for "${family}", which was NOT downloaded. If the brand uses italic anywhere, re-run with \`--italic\` \u2014 otherwise the browser slants the upright face, which is not the same shapes.`
+    ];
+  }
+  return [];
+}
+function fetchHints({
+  family,
+  downloadedWeights,
+  downloadedStyles,
+  incomplete,
+  wiring,
+  provider,
+  wantedStyles,
+  availableStyles
+}) {
+  return [
+    WIRING_HINT[wiring](family),
+    ...italicHints(family, wantedStyles, availableStyles, downloadedStyles, provider),
+    `Record the exact weights (${downloadedWeights.join(", ")}) in src/brand/tokens.json and BRAND.md \u2014 a weight tokens.json lists but nothing loads renders as a synthesized fallback, and verify warns about it.`,
+    ...incomplete.length > 0 ? [
+      // The remedy is provider-specific: only a Google family has an @import
+      // to fall back on, and telling an agent to keep one for a Fontsource
+      // family sends it to write an import Google will 400.
+      provider === "google" ? `PARTIAL: ${incomplete.join(", ")} did not download and is NOT in the \`fontFace\` block. Re-run \`baker brand fonts fetch "${family}" --weights ${incomplete.join(",")}\` \u2014 a Google @import cannot cover those weights, because the build drops it before the page loads.` : `PARTIAL: ${incomplete.join(", ")} did not download and is NOT in the \`fontFace\` block. ${PROVIDER_LABEL[provider]} does not serve them, so re-run \`baker brand fonts fetch "${family}" --weights ${downloadedWeights.join(",")}\` and record only those weights in src/brand/BRAND.md.`
+    ] : [],
+    `Licensing: ${PROVIDER_LABEL[provider]} carries open-licensed families. A client's own typeface is licensed for its landings and ads too \u2014 self-host it without asking about rights.`
+  ];
+}
+async function wireFontFaceIntoStylesheet(css, family, fontFace) {
+  if (!css) return "no-stylesheet";
+  const wired = upsertFontFaceCss(css, family, fontFace);
+  if (wired === css) return "already-wired";
+  await writeFile(path.resolve(process.cwd(), GLOBAL_CSS), wired);
+  return "written";
+}
+function failResolution(family, weights, outcome) {
+  if (outcome.reason === "unreachable") {
+    return fail(
+      "CATALOGUE_UNREACHABLE",
+      `Could not reach ${PROVIDER_LABEL[outcome.provider]} to ask about "${family}".`,
+      {
+        action: "Run the same command again.",
+        explanation: `${PROVIDER_LABEL[outcome.provider]} did not answer, which is not the same as not having the family \u2014 so nothing was concluded from it. Guessing either way would self-host the wrong build, or report a real family as missing.`,
+        provider: outcome.provider
+      }
+    );
+  }
+  if (outcome.reason === "ambiguous-subsets") {
+    return fail(
+      "SUBSET_AMBIGUOUS",
+      `${PROVIDER_LABEL[outcome.provider]} serves "${family}" in several subsets but reports no unicode-range to tell them apart.`,
+      {
+        action: `Retry with a single --subsets value, e.g. --subsets ${outcome.available[0] ?? "latin"}.`,
+        explanation: "Two @font-face rules with the same family, style and weight and no unicode-range both claim every character, so the last one silently wins and the other file is downloaded and never read.",
+        available: outcome.available
+      }
+    );
+  }
+  if (outcome.reason === "subset") {
+    return fail("SUBSET_NOT_SERVED", `${PROVIDER_LABEL[outcome.provider]} has "${family}", but not in that subset.`, {
+      action: `Retry with --subsets set to one it serves: ${outcome.available.join(",")}.`,
+      explanation: "A family is split into unicode subsets and not every family ships every one. The weights you asked for are fine \u2014 only the subset is wrong.",
+      available: outcome.available
+    });
+  }
+  if (outcome.reason === "weight") {
+    return fail(
+      "FONT_NOT_SERVED",
+      `${PROVIDER_LABEL[outcome.provider]} has "${family}", but not at weight ${weights.join("/")}.`,
+      {
+        action: `Retry with --weights set to one of these: ${outcome.available.join(",")}.`,
+        explanation: "The family exists; the weight you asked for is not one it ships.",
+        served: outcome.available
+      }
+    );
+  }
+  return failUnknownFamily(family);
+}
+async function failUnknownFamily(family) {
+  const didYouMean = suggestFamilies(family, await fontsourceCatalogue(PROVIDER_DEPS));
+  return fail("FONT_NOT_SERVED", `No font catalogue carries a family called "${family}".`, {
+    action: didYouMean.length ? `Did you mean one of these? ${didYouMean.join(", ")}. Retry with the exact name, and update the --font-* token in ${GLOBAL_CSS} to match whichever you pick.` : `Check the exact spelling, then retry. If it is a commercial typeface, add the file to ${FONTS_DIR} and write the @font-face by hand \u2014 it cannot be downloaded.`,
+    explanation: `Tried ${FONT_PROVIDERS.join(" then ")}. Family names are case- and space-sensitive in every catalogue.`,
+    tried: [...FONT_PROVIDERS],
+    ...didYouMean.length ? { didYouMean } : {}
+  });
+}
+async function listFontFiles() {
+  try {
+    const entries = await readdir(path.resolve(process.cwd(), FONTS_DIR), { withFileTypes: true });
+    return entries.filter((e) => e.isFile()).map((e) => e.name);
+  } catch {
+    return [];
+  }
+}
+async function readGlobalCss() {
+  try {
+    return await readFile(path.resolve(process.cwd(), GLOBAL_CSS), "utf8");
+  } catch {
+    return "";
+  }
+}
+async function unresolvedAction(css, unresolved) {
+  const { plans } = planFontAdoption(await astroSources(), unresolved);
+  if (plans.length > 0) {
+    const names = plans.map((p) => `"${p.family}"`).join(", ");
+    return `Run \`baker brand fonts adopt\` \u2014 ${names} is already self-hosted by ${plans[0]?.files.join(", ")}, so it only needs moving into ${GLOBAL_CSS} to load on every page. Don't fetch it: that downloads a different build of the same face.`;
+  }
+  const viaFontsource = [...fontsourceFamilies(css)];
+  const stranded = unresolved.filter((family) => viaFontsource.includes(family.toLowerCase()));
+  if (stranded.length > 0) {
+    return `Run \`baker brand fonts fetch "${stranded[0]}"\` to self-host it. Its only provider is an @fontsource import, and that package does not survive a workspace sync \u2014 the import is left pointing at nothing, which fails the build before the font check even runs.`;
+  }
+  return `Run \`baker brand fonts fetch "${unresolved[0]}"\` to self-host it, which writes the @font-face for you. For a face no catalogue carries, add an @font-face pointing at a file in ${FONTS_DIR}.`;
+}
+var fontsCheckCommand = defineCommand({
+  meta: {
+    name: "check",
+    description: "Verify the brand's fonts really exist. First: every --font-* family in src/styles/global.css must be provided by a local @font-face, or it renders as a fallback on every page \u2014 a Google @import does not provide one here, the build drops it before the page loads. Then, for families still requested from Google, ask Google what it actually serves \u2014 a weight nobody serves is silently synthesized."
+  },
+  async run() {
+    const css = await readGlobalCss();
+    const requests = googleFontRequests(css);
+    const unresolved = unresolvedBrandFamilies(css);
+    if (unresolved.length > 0) {
+      fail("FONT_NOT_LOADED", `Nothing loads ${unresolved.map((f) => `"${f}"`).join(", ")} in ${GLOBAL_CSS}.`, {
+        action: await unresolvedAction(css, unresolved),
+        explanation: "The family is declared as a brand font but no @font-face provides it, so every page silently renders a fallback. A Google @import does not count: Astro merges component CSS ahead of global.css into one inlined <style>, so the import lands after rules and the browser drops it \u2014 measured on a live client site. The client's verify fails on this too.",
+        unresolved
+      });
+    }
+    if (requests.length === 0) {
+      writeJson({
+        ok: true,
+        data: { families: [], selfHosted: true },
+        hints: [
+          `No Google Fonts requested in ${GLOBAL_CSS}, and every brand face is provided by an @font-face \u2014 nothing to verify against Google.`
+        ]
+      });
+      return;
+    }
+    const families = await checkFontRequests(requests, fetchGoogleCss);
+    const broken = families.filter((f) => f.missing.length > 0);
+    if (broken.length > 0) {
+      const summary = broken.map(
+        (f) => f.cause === "unknown-family" ? `${f.family} (no such family on Google Fonts \u2014 check the exact spelling)` : `${f.family} ${f.missing.join("/")} (served: ${f.served.join("/") || "none"})`
+      ).join("; ");
+      fail("FONT_NOT_SERVED", `Google Fonts does not serve: ${summary}`, {
+        action: `Correct the family name or weight in ${GLOBAL_CSS} and src/brand/BRAND.md, picking from the \`served\` weights below.`,
+        explanation: "A requested weight Google does not serve is silently synthesized by the browser, so the page looks subtly wrong with nothing failing.",
+        // The per-family breakdown is the point of the command, so it ships on
+        // the failure path too — otherwise the only remedy is re-running the
+        // command that just failed. Healthy families are included so a
+        // multi-family brand shows what NOT to touch.
+        families
+      });
+    }
+    writeJson({
+      ok: true,
+      data: { families },
+      hints: [
+        "Every requested family and weight is really served by Google.",
+        `To stop depending on Google at page load, run \`baker brand fonts fetch "<family>"\` to self-host into ${FONTS_DIR}.`
+      ]
+    });
+  }
+});
+var fontsFetchCommand = defineCommand({
+  meta: {
+    name: "fetch",
+    description: "Download a font from Google Fonts or Fontsource into src/brand/fonts/ and write its @font-face into src/styles/global.css above @theme, so the family actually loads. Use when a brand font should be self-hosted rather than requested from a third party on every page load."
+  },
+  args: {
+    family: { type: "positional", required: true, description: 'Font family, e.g. "DM Sans"' },
+    weights: {
+      type: "string",
+      description: "Comma-separated weights (default: the weights global.css already requests or self-hosts, else 400)"
+    },
+    subsets: {
+      type: "string",
+      description: `Comma-separated unicode subsets (default: the subsets global.css already self-hosts, else ${DEFAULT_SUBSETS_LABEL})`
+    },
+    italic: {
+      type: "boolean",
+      description: "Also self-host the family's italic faces (default: on when global.css already loads one, off otherwise)"
+    }
+  },
+  async run({ args }) {
+    const family = String(args.family).trim();
+    if (!family) fail("INVALID_FAMILY", 'Pass a font family, e.g. `baker brand fonts fetch "DM Sans"`.');
+    const css = await readGlobalCss();
+    const declared = googleFontRequests(css).find((r) => r.family.toLowerCase() === family.toLowerCase());
+    const provided = declared?.weights.length ? declared.weights : selfHostedWeights(css, family);
+    const weights = resolveFetchWeights(args.weights, provided);
+    if (weights.length === 0) {
+      fail("INVALID_WEIGHTS", `"${args.weights}" has no usable weight \u2014 pass whole hundreds, e.g. --weights 400,700.`);
+    }
+    const wanted = new Set(resolveFetchSubsets(args.subsets, selfHostedSubsets(css, family)));
+    const styles = resolveFetchStyles(args.italic, selfHostedStyles(css, family));
+    const resolved = await resolveBrandFaces(family, weights, [...wanted], PROVIDER_DEPS, styles);
+    if (!resolved.ok) return failResolution(family, weights, resolved);
+    const faces = resolved.faces;
+    const fontsDir = path.resolve(process.cwd(), FONTS_DIR);
+    await mkdir(fontsDir, { recursive: true });
+    const downloaded = [];
+    for (const face of faces) {
+      const res = await fetch(face.url, {
+        headers: { "User-Agent": BROWSER_UA },
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+      });
+      if (!res.ok) continue;
+      await writeFile(path.join(fontsDir, fontFileName(face)), Buffer.from(await res.arrayBuffer()));
+      downloaded.push(face);
+    }
+    const written = downloaded.map(fontFileName);
+    if (written.length === 0) {
+      fail("DOWNLOAD_FAILED", `Could not download any file for "${family}".`, {
+        action: "Retry; if it keeps failing, keep the Google @import and note it in BRAND.md.",
+        explanation: "The font stylesheet resolved but the font files themselves did not download."
+      });
+    }
+    const fontFace = renderFontFaceCss(downloaded);
+    const downloadedWeights = [...new Set(downloaded.map((f) => f.weight))].sort((a, b) => a - b);
+    const downloadedStyles = [...new Set(downloaded.map((f) => f.style))].sort();
+    const incomplete = weights.filter((w) => !downloadedWeights.includes(w));
+    const wiring = await wireFontFaceIntoStylesheet(css, family, fontFace);
+    writeJson({
+      ok: true,
+      data: {
+        family,
+        provider: resolved.provider,
+        weights: downloadedWeights,
+        styles: downloadedStyles,
+        files: written,
+        fontFace,
+        stylesheet: wiring
+      },
+      hints: fetchHints({
+        family,
+        downloadedWeights,
+        downloadedStyles,
+        incomplete,
+        wiring,
+        provider: resolved.provider,
+        wantedStyles: styles,
+        availableStyles: resolved.availableStyles
+      })
+    });
+  }
+});
+async function astroSources() {
+  const out = [];
+  let entries;
+  try {
+    entries = await readdir("src", { recursive: true, withFileTypes: true });
+  } catch {
+    return out;
+  }
+  for (const entry of entries) {
+    if (!entry.isFile() || !entry.name.endsWith(".astro")) continue;
+    const file = path.posix.join(entry.parentPath ?? "src", entry.name);
+    try {
+      out.push({ path: file, source: await readFile(file, "utf8") });
+    } catch {
+    }
+  }
+  return out;
+}
+var fontsAdoptCommand = defineCommand({
+  meta: {
+    name: "adopt",
+    description: "Move brand faces a page already self-hosts into src/styles/global.css, so every page loads them instead of just that one. Use when `check` reports a family as not loaded but the font files are already in src/brand/fonts/ \u2014 downloading it again would hand that page a different build of the same face."
+  },
+  async run() {
+    const css = await readGlobalCss();
+    if (!css) fail("NO_STYLESHEET", `There is no ${GLOBAL_CSS} to adopt faces into.`);
+    const unresolved = unresolvedBrandFamilies(css);
+    if (unresolved.length === 0) {
+      writeJson({
+        ok: true,
+        data: { adopted: [], conflicts: [] },
+        hints: [`Every --font-* family in ${GLOBAL_CSS} is already loaded by it \u2014 nothing to adopt.`]
+      });
+      return;
+    }
+    const { plans, conflicts } = planFontAdoption(await astroSources(), unresolved);
+    const available = new Set(await listFontFiles());
+    const adopted = [];
+    const skipped = [];
+    let next = css;
+    for (const plan of plans) {
+      const missing = missingFontFiles(plan.urls, available);
+      if (missing.length > 0) {
+        skipped.push({ family: plan.family, reason: `${missing.join(", ")} is not in ${FONTS_DIR}` });
+        continue;
+      }
+      next = upsertFontFaceCss(next, plan.family, plan.blocks.join("\n"));
+      adopted.push({
+        family: plan.family,
+        files: plan.files,
+        weights: plan.blocks.map((b) => b.match(/font-weight\s*:\s*([^;]+)/i)?.[1]?.trim() ?? "400")
+      });
+    }
+    if (adopted.length === 0) {
+      if (conflicts.length > 0) {
+        fail(
+          "ADOPTION_CONFLICT",
+          `${conflicts.map((c) => `"${c.family}" is declared differently in ${c.files.join(" and ")}`).join("; ")}.`,
+          {
+            action: "Make the declarations match \u2014 same weights, same files \u2014 then re-run. Pick the one whose page renders correctly.",
+            explanation: "One global scope holds one mapping per family, so adopting would silently repaint whichever page lost.",
+            conflicts
+          }
+        );
+      }
+      if (skipped.length > 0) {
+        fail("FONT_FILE_MISSING", `${skipped.map((s) => `${s.family} \u2014 ${s.reason}`).join("; ")}.`, {
+          action: `Add the missing file to ${FONTS_DIR}, or fix the src: url() in the page that declares it, then re-run.`,
+          explanation: "The page declares the face but points at a file that is not in the repo, so the rule renders as a fallback. Moving it into the stylesheet would spread that fallback to every page.",
+          skipped
+        });
+      }
+      fail("NOTHING_TO_ADOPT", `No page declares a face for ${unresolved.map((f) => `"${f}"`).join(", ")}.`, {
+        action: `Self-host it instead: \`baker brand fonts fetch "${unresolved[0]}"\`.`,
+        explanation: "Adopting only moves faces the repo already ships; it never downloads one."
+      });
+    }
+    await writeFile(path.resolve(process.cwd(), GLOBAL_CSS), next);
+    for (const plan of plans.filter((p) => adopted.some((a) => a.family === p.family))) {
+      for (const file of plan.files) {
+        const source = await readFile(file, "utf8");
+        await writeFile(file, stripFontFaceBlocks(source, plan.family));
+      }
+    }
+    writeJson({
+      ok: true,
+      data: { adopted, conflicts, skipped },
+      hints: [
+        `Moved ${adopted.map((a) => `"${a.family}" (${a.weights.join("/")})`).join(", ")} into ${GLOBAL_CSS} and removed the page copies, so every page loads them \u2014 not just the one that declared them.`,
+        ...conflicts.length > 0 ? [
+          `CONFLICT: ${conflicts.map((c) => `"${c.family}" is declared differently in ${c.files.join(" and ")}`).join("; ")}. One global scope can hold only one mapping, so pick which files the family should use and make the declarations match before re-running.`
+        ] : [],
+        ...skipped.length > 0 ? [`SKIPPED: ${skipped.map((s) => `${s.family} \u2014 ${s.reason}`).join("; ")}.`] : [],
+        `Run \`baker brand fonts check\` to confirm nothing is left unresolved.`
+      ]
+    });
+  }
+});
+var fontsCommand = defineCommand({
+  meta: {
+    name: "fonts",
+    description: `Verify and self-host the brand's typefaces.
+
+Start here: \`baker brand fonts check\` \u2014 confirms the fonts the brand claims really load.
+
+Subcommands:
+  baker brand fonts check           \u2014 fail if any --font-* family has nothing loading it, then ask Google what it actually serves for the ones global.css requests
+  baker brand fonts fetch <family>  \u2014 download a family into src/brand/fonts/ and wire its @font-face into src/styles/global.css
+  baker brand fonts adopt           \u2014 move faces a page already self-hosts into global.css, so every page loads them. Try this BEFORE fetch when the font files are already in src/brand/fonts/`
+  },
+  subCommands: {
+    check: fontsCheckCommand,
+    fetch: fontsFetchCommand,
+    adopt: fontsAdoptCommand
+  }
+});
+
+export {
+  fetchJson,
+  lookupGoogleCss,
+  fontsCheckCommand,
+  fontsFetchCommand,
+  fontsAdoptCommand,
+  fontsCommand
+};
+//# sourceMappingURL=chunk-RHNNFCRY.js.map