@koda-sl/baker-cli 0.535.0 → 0.537.0

package/dist/leads-GZ7RFM7D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/leads.ts","../src/commands/ads/meta/lead-form-writes.ts"],"sourcesContent":["import { isMetaLeadAdsRefusal } from \"@baker/api/ads-meta\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeAdsJson, writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport {\n  leadFormsArchiveCommand,\n  leadFormsCreateCommand,\n  leadFormsDuplicateCommand,\n  leadFormsSpecCommand,\n  leadFormsUnarchiveCommand,\n} from \"./lead-form-writes.ts\";\nimport { csvOrJson, handleMetaError } from \"./shared.ts\";\n\n/** An instant form attached to a Facebook Page. */\nexport interface MetaLeadForm {\n  id: string;\n  name?: string;\n  status?: string;\n  locale?: string;\n  leads_count?: number;\n  created_time?: string;\n}\n\n/** One page of leads plus the cursor that continues it. */\nexport interface MetaLeadPage {\n  leads: MetaLead[];\n  /** Present only while Meta says another page exists. */\n  nextCursor?: string;\n  /** What the backend says about this page (every answer masked when it could not tell contact questions apart). */\n  hints?: string[];\n}\n\n/** One lead, already shaped by the backend (contact values masked unless --full). */\nexport interface MetaLead {\n  id: string;\n  created_time?: string;\n  ad_id?: string;\n  ad_name?: string;\n  adset_id?: string;\n  adset_name?: string;\n  campaign_id?: string;\n  campaign_name?: string;\n  form_id?: string;\n  is_organic?: boolean;\n  platform?: string;\n  answers: Record<string, string>;\n  /** Each disclaimer checkbox by its key: ticked or not. */\n  consents?: Record<string, boolean>;\n  partner_name?: string;\n}\n\nregisterSchema({\n  command: \"ads.meta.lead-forms\",\n  description:\n    \"List the instant (lead) forms on a Facebook Page, with how many leads each has collected. Start here: a lead is fetched by form id. Use a Page from `baker ads meta pages` with hasPageAccessToken: true.\",\n  args: {\n    \"page-id\": {\n      type: \"string\",\n      description: \"Facebook Page ID — from `baker ads meta pages` with hasPageAccessToken: true\",\n      required: true,\n    },\n    full: { type: \"boolean\", description: \"Include each form's questions\", required: false },\n    output: { type: \"string\", description: \"json|csv\", required: false, default: \"json\" },\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.leads\",\n  description:\n    \"Read the leads an instant form collected. Contact details (email, phone) come back masked; pass --full only when the raw values are genuinely needed, e.g. handing them to a CRM.\",\n  args: {\n    \"form-id\": { type: \"string\", description: \"Instant form ID — from `baker ads meta lead-forms`\", required: false },\n    \"ad-id\": { type: \"string\", description: \"Read the leads of one ad instead of a whole form\", required: false },\n    \"adset-id\": { type: \"string\", description: \"Read the leads of every ad in an ad set\", required: false },\n    \"campaign-id\": { type: \"string\", description: \"Read the leads of every ad in a campaign\", required: false },\n    since: { type: \"string\", description: \"Earliest submission date, YYYY-MM-DD\", required: false },\n    until: { type: \"string\", description: \"Latest submission date, YYYY-MM-DD (inclusive)\", required: false },\n    limit: { type: \"string\", description: \"Leads per page (default 100, max 500)\", required: false },\n    after: {\n      type: \"string\",\n      description: \"Cursor from a previous call's nextCursor — fetches the following page\",\n      required: false,\n    },\n    full: { type: \"boolean\", description: \"Return raw contact details instead of masked ones\", required: false },\n    output: { type: \"string\", description: \"json|csv\", required: false, default: \"json\" },\n  },\n});\n\n/**\n * A form that exists but has never collected anything is the single most common\n * thing to misread here — it looks identical to a permissions problem in the\n * output, and the remedies are opposite. Say which it is.\n */\n/** The backend drains instant forms up to this many; see `META_LEAD_FORMS_MAX`. */\nconst LEAD_FORMS_CAP = 500;\n\nexport function leadFormHints(forms: MetaLeadForm[]): string[] {\n  if (forms.length === 0) {\n    return [\"This Page has NO instant forms. Nothing to read leads from — the form has to be created first.\"];\n  }\n  if (forms.length >= LEAD_FORMS_CAP) {\n    return [\n      `PARTIAL LIST — this Page has at least ${LEAD_FORMS_CAP} instant forms and only the first ${LEAD_FORMS_CAP} came back. Do not describe this as every form on the Page.`,\n    ];\n  }\n  const empty = forms.filter((form) => (form.leads_count ?? 0) === 0);\n  if (empty.length === forms.length) {\n    return [\n      \"Every form on this Page has collected 0 leads. That is a real, readable answer — the connection works. Do not retry and do not report it as a permissions problem.\",\n    ];\n  }\n  return [];\n}\n\n/**\n * A `FORBIDDEN` that Baker itself produced is already conclusive, so it must not\n * collect the generic ambiguous-403 remedy.\n *\n * `metaForbiddenFix` exists for Meta's own 403, which covers two causes with\n * opposite fixes and can only be told apart by testing the blast radius. Pasting\n * that after *\"this needs switching on by the Baker team\"* would hand the agent\n * a paragraph suggesting a reconnect right underneath a sentence saying a\n * reconnect cannot help — and the agent would pass it on, costing the client a\n * pointless round trip through their Meta login. Everything that is genuinely\n * Meta's still goes through the normal handler.\n */\nfunction handleLeadsError(err: unknown): never {\n  if (err instanceof ApiError && err.code === \"FORBIDDEN\" && isMetaLeadAdsRefusal(err.message)) {\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: { action: \"reject\", explanation: err.message },\n        retryable: false,\n      },\n    });\n    process.exit(1);\n  }\n  handleMetaError(err);\n}\n\n/**\n * What the agent has to know before it reports a number.\n *\n * Counting is what this command is mostly used for, so a page that is full is\n * the dangerous case: without a word, 100 rows read as \"100 leads\" and the\n * client is told something false. The cursor is the remedy, and it has to be\n * named in the same breath as the warning.\n */\nexport function leadPageHints(page: MetaLeadPage, full: boolean): string[] {\n  const hints: string[] = [];\n  if (page.nextCursor) {\n    hints.push(\n      `PARTIAL PAGE — more leads exist. This is ${page.leads.length} of an unknown larger number; do NOT report it as a total. Fetch the next page with \\`--after ${page.nextCursor}\\` (repeat until no nextCursor), or narrow the window with --since/--until.`,\n    );\n  }\n  if (!full) {\n    hints.push(\n      \"Answers that give contact details (email, phone, any question asking for one) are masked. Report on them as they are; pass --full only when the raw values have to leave Baker (a CRM hand-off), and never paste them into the chat otherwise.\",\n    );\n  }\n  hints.push(...(page.hints ?? []));\n  return hints;\n}\n\nconst leadFormsListArgs = {\n  \"page-id\": { type: \"string\", description: \"Facebook Page ID\" },\n  full: { type: \"boolean\", description: \"Include each form's questions\" },\n  output: { type: \"string\", description: \"Output format: json|csv|jsonl|md\", default: \"json\" },\n} as const;\n\nconst leadFormsListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List the Instant Forms on a Facebook Page, with lead counts. Choose a Page with hasPageAccessToken: true from `baker ads meta pages`. Pass --full to include questions.\",\n  },\n  args: leadFormsListArgs,\n  run: async ({ args }) => {\n    try {\n      const pageId = args[\"page-id\"] as string | undefined;\n      if (!pageId) {\n        handleLeadsError(\n          new Error(\n            \"--page-id is required. Run `baker ads meta pages` and choose a Page with hasPageAccessToken: true.\",\n          ),\n        );\n      }\n      const params: Record<string, string> = { \"page-id\": pageId };\n      if (args.full) params.full = \"true\";\n      const data = await apiGet<MetaLeadForm[]>(\"/api/ads/meta/lead-forms\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      const hints = leadFormHints(data);\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      handleLeadsError(err);\n    }\n  },\n});\n\nexport const leadFormsCommand = defineCommand({\n  meta: {\n    name: \"lead-forms\",\n    description: `List Instant Forms on a Facebook Page, or stage a new one, a changed copy, an archive.\nA form is permanent on Meta and nothing on it changes once made: to change one, duplicate it with changes and archive the old one.\nExamples:\n  baker ads meta lead-forms --page-id 100635183117758\n  baker ads meta lead-forms --page-id 100635183117758 --full\n  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json\n  baker ads meta lead-forms spec 987654321                       — a live form as a create --file payload\n  baker ads meta lead-forms duplicate 987654321 --account-id act_123 --name \"Free audit (ES)\" --locale ES_LA\n  baker ads meta lead-forms archive 987654321 --account-id act_123`,\n  },\n  args: leadFormsListArgs,\n  subCommands: {\n    list: leadFormsListCommand,\n    create: leadFormsCreateCommand,\n    spec: leadFormsSpecCommand,\n    duplicate: leadFormsDuplicateCommand,\n    archive: leadFormsArchiveCommand,\n    unarchive: leadFormsUnarchiveCommand,\n  },\n  default: \"list\",\n});\n\nexport const leadsCommand = defineCommand({\n  meta: {\n    name: \"leads\",\n    description: `Read the leads an instant form collected. Every question comes back; email and phone answers are MASKED unless you pass --full, so you can report on what a form is collecting without moving contact details around.\n\nExamples:\n  baker ads meta leads --form-id 987654321\n  baker ads meta leads --form-id 987654321 --since 2026-08-01 --until 2026-08-31\n  baker ads meta leads --ad-id 6123456789 --limit 50\n  baker ads meta leads --adset-id 6123456780 --since 2026-08-01   # every ad in the ad set (Meta has no ad set edge)\n  baker ads meta leads --form-id 987654321 --after <nextCursor>   # the next page\n  baker ads meta leads --form-id 987654321 --full            # raw contact details — only when handing leads over\n\nResults are PAGED. A response carrying \\`nextCursor\\` is not the whole set — follow it before reporting any total.`,\n  },\n  args: {\n    \"form-id\": { type: \"string\", description: \"Instant form ID (from `baker ads meta lead-forms`)\" },\n    \"ad-id\": { type: \"string\", description: \"Read one ad's leads instead of a whole form\" },\n    \"adset-id\": { type: \"string\", description: \"Read the leads of every ad in an ad set\" },\n    \"campaign-id\": { type: \"string\", description: \"Read the leads of every ad in a campaign\" },\n    since: { type: \"string\", description: \"Earliest submission date, YYYY-MM-DD\" },\n    until: { type: \"string\", description: \"Latest submission date, YYYY-MM-DD (inclusive)\" },\n    limit: { type: \"string\", description: \"Leads per page (default 100, max 500)\" },\n    after: { type: \"string\", description: \"Cursor from a previous call's nextCursor\" },\n    full: { type: \"boolean\", description: \"Return raw contact details instead of masked ones\" },\n    output: { type: \"string\", description: \"Output format: json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    try {\n      const params: Record<string, string> = {};\n      for (const flag of [\"form-id\", \"ad-id\", \"adset-id\", \"campaign-id\"] as const) {\n        const value = args[flag];\n        if (typeof value === \"string\" && value.length > 0) params[flag] = value;\n      }\n      if (Object.keys(params).length !== 1) {\n        handleLeadsError(\n          new Error(\"Pass one of --form-id (from `baker ads meta lead-forms`), --ad-id, --adset-id or --campaign-id.\"),\n        );\n      }\n      if (args.since) params.since = args.since as string;\n      if (args.until) params.until = args.until as string;\n      if (args.limit) params.limit = String(args.limit);\n      if (args.after) params.after = String(args.after);\n      if (args.full) params.full = \"true\";\n      const page = await apiGet<MetaLeadPage>(\"/api/ads/meta/leads\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(page.leads as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      writeJsonEnvelope({\n        ok: true,\n        data: page.leads,\n        ...(page.nextCursor ? { nextCursor: page.nextCursor } : {}),\n        hints: leadPageHints(page, args.full === true),\n      });\n    } catch (err) {\n      handleLeadsError(err);\n    }\n  },\n});\n","import { defineCommand } from \"citty\";\nimport { apiGet } from \"../../../client.ts\";\nimport { repeatedValues } from \"../../../lib/repeatedFlags.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleMetaError } from \"./shared.ts\";\nimport {\n  bareAccountId,\n  failWriteValidation,\n  loadJsonFileArg,\n  mergePayload,\n  requireTarget,\n  stageOp,\n  upper,\n} from \"./write-shared.ts\";\n\n/**\n * Staging Instant Forms. A form is permanent on Meta — it is never deleted,\n * only archived — and nothing on it changes once it exists, so every write\n * here is a new form (create, duplicate) or an archive / unarchive, all staged\n * on this chat's draft and applied at publish.\n */\n\ntype Args = Record<string, unknown>;\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads meta draft`.\";\n\nconst str = (value: unknown): string | undefined => (typeof value === \"string\" && value.length > 0 ? value : undefined);\n\n/** `\"Question? => answer | answer\"` → a CUSTOM question, multiple choice when it lists answers. */\nfunction customQuestion(value: string): Record<string, unknown> {\n  const [label = \"\", answers] = value.split(\"=>\").map((part) => part.trim());\n  const options = answers\n    ?.split(\"|\")\n    .map((answer) => answer.trim())\n    .filter(Boolean)\n    .map((answer) => ({ value: answer }));\n  return { type: \"CUSTOM\", label, ...(options && options.length > 0 ? { options } : {}) };\n}\n\nfunction questionsFromFlags(args: Args, rawArgs: readonly string[] | undefined): unknown[] | undefined {\n  const predefined = (str(args.questions) ?? \"\")\n    .split(\",\")\n    .map((type) => type.trim().toUpperCase())\n    .filter(Boolean)\n    .map((type) => ({ type }));\n  const custom = repeatedValues(rawArgs, \"question\", args.question).map(customQuestion);\n  const all = [...predefined, ...custom];\n  return all.length > 0 ? all : undefined;\n}\n\n/**\n * The intro fields the flags name, and only those: a duplicate keeps every\n * other intro field of the live form (`mergeDuplicateSpec`), so `--intro-title`\n * alone does not wipe the text and `--intro-button` alone is not dropped.\n */\nfunction introFromFlags(args: Args, rawArgs: readonly string[] | undefined): Record<string, unknown> | undefined {\n  const content = repeatedValues(rawArgs, \"intro-text\", args[\"intro-text\"]);\n  const set = {\n    ...(str(args[\"intro-title\"]) ? { title: str(args[\"intro-title\"]) } : {}),\n    ...(content.length > 0 ? { style: content.length > 1 ? \"LIST_STYLE\" : \"PARAGRAPH_STYLE\", content } : {}),\n    ...(str(args[\"intro-button\"]) ? { buttonText: str(args[\"intro-button\"]) } : {}),\n  };\n  return Object.keys(set).length > 0 ? set : undefined;\n}\n\nfunction thankYouFromFlags(args: Args): Record<string, unknown> | undefined {\n  const fields = {\n    title: str(args[\"thank-you-title\"]),\n    body: str(args[\"thank-you-body\"]),\n    buttonType: upper(args[\"thank-you-button\"]),\n    buttonText: str(args[\"thank-you-button-text\"]),\n    websiteUrl: str(args[\"thank-you-url\"]),\n    businessPhoneNumber: str(args[\"thank-you-phone\"]),\n    countryCode: upper(args[\"thank-you-country\"]),\n  };\n  const set = Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));\n  return Object.keys(set).length > 0 ? set : undefined;\n}\n\nfunction trackingFromFlags(args: Args, rawArgs: readonly string[] | undefined): Record<string, string> | undefined {\n  const pairs = repeatedValues(rawArgs, \"tracking\", args.tracking).map((pair) => {\n    const at = pair.indexOf(\"=\");\n    if (at <= 0) failWriteValidation(`--tracking takes name=value, got \"${pair}\"`);\n    return [pair.slice(0, at).trim(), pair.slice(at + 1).trim()] as const;\n  });\n  return pairs.length > 0 ? Object.fromEntries(pairs) : undefined;\n}\n\n/** The `leadForm.create` fields the flags name; anything a flag leaves out comes from `--file`. */\nexport function leadFormPayloadFromFlags(args: Args, rawArgs?: readonly string[]): Record<string, unknown> {\n  const quality = args[\"higher-intent\"] ?? args[\"optimized-for-quality\"];\n  return {\n    page_id: str(args[\"page-id\"]),\n    name: str(args.name),\n    locale: upper(args.locale),\n    questionPageHeadline: str(args.headline),\n    questions: questionsFromFlags(args, rawArgs),\n    privacyPolicyUrl: str(args[\"privacy-policy-url\"]),\n    privacyPolicyLinkText: str(args[\"privacy-link-text\"]),\n    followUpActionUrl: str(args[\"follow-up-url\"]),\n    optimizedForQuality: typeof quality === \"boolean\" ? quality : undefined,\n    intro: introFromFlags(args, rawArgs),\n    thankYou: thankYouFromFlags(args),\n    sharing: str(args.sharing)?.toLowerCase(),\n    smsVerification: args[\"sms-verification\"] === true ? true : undefined,\n    trackingParameters: trackingFromFlags(args, rawArgs),\n  };\n}\n\n/**\n * A `--file` form as staged. `lead-forms spec > form.json` writes the CLI's\n * `{ok, data, hints}` envelope, so the form is its `data`; a hand-written file\n * is the form itself.\n */\nexport function formFileForStaging(raw: Record<string, unknown>): Record<string, unknown> {\n  const data = raw.ok === true && \"data\" in raw ? raw.data : raw;\n  return data && typeof data === \"object\" && !Array.isArray(data) ? (data as Record<string, unknown>) : raw;\n}\n\n/** The screens a duplicate changes field by field, so a flag naming one field keeps the others. */\nconst SCREENS = [\"intro\", \"thankYou\"] as const;\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === \"object\" && !Array.isArray(value) ? (value as Record<string, unknown>) : undefined;\n}\n\n/** `over` on `base`, the intro and thank-you screens merged a field at a time. */\nfunction mergeOver(base: Record<string, unknown>, over: Record<string, unknown>): Record<string, unknown> {\n  const merged = mergePayload(base, over);\n  for (const screen of SCREENS) {\n    const from = record(base[screen]);\n    const to = record(over[screen]);\n    if (from && to) merged[screen] = mergePayload(from, to);\n  }\n  return merged;\n}\n\n/**\n * A duplicate: the live form, then the `--file` changes over it, then the\n * flags over both. Forms are permanent, so the intro and thank-you screens\n * change only in the fields named — never wholesale.\n */\nexport function mergeDuplicateSpec(\n  live: Record<string, unknown>,\n  changes: Record<string, unknown>,\n  flags: Record<string, unknown>,\n): Record<string, unknown> {\n  return mergeOver(mergeOver(live, changes), flags);\n}\n\nconst FORM_FLAG_ARGS = {\n  name: { type: \"string\", description: \"Form name — unique among the Page's forms (archived ones count)\" },\n  locale: {\n    type: \"string\",\n    description:\n      \"Form language, e.g. EN_US, ES_LA, PT_BR, FR_FR, DE_DE (Meta's 32) — Meta words its own questions in it\",\n  },\n  headline: { type: \"string\", description: \"Headline above the questions\" },\n  questions: {\n    type: \"string\",\n    description:\n      \"Questions Meta words itself, comma-separated: FULL_NAME,EMAIL,PHONE,WORK_EMAIL,COMPANY_NAME,JOB_TITLE,CITY,ZIP,DOB…\",\n  },\n  question: {\n    type: \"string\",\n    description: 'A custom question, repeatable: \"Question?\" or multiple choice \"Question? => Answer | Answer\"',\n  },\n  \"privacy-policy-url\": { type: \"string\", description: \"Public https privacy policy (required)\" },\n  \"privacy-link-text\": { type: \"string\", description: \"Words of the privacy link (≤70, default Privacy Policy)\" },\n  \"follow-up-url\": { type: \"string\", description: \"https link of the default View website button\" },\n  \"higher-intent\": {\n    type: \"boolean\",\n    description: \"Higher intent: people review their answers before submitting (default: more volume)\",\n  },\n  \"optimized-for-quality\": { type: \"boolean\", description: \"Same as --higher-intent\" },\n  \"intro-title\": { type: \"string\", description: \"Intro screen title\" },\n  \"intro-text\": { type: \"string\", description: \"Intro paragraph; repeat for bullet points\" },\n  \"intro-button\": { type: \"string\", description: \"Intro screen button text\" },\n  \"thank-you-title\": { type: \"string\", description: \"Thank-you screen title\" },\n  \"thank-you-body\": { type: \"string\", description: \"Thank-you screen text\" },\n  \"thank-you-button\": {\n    type: \"string\",\n    description: \"VIEW_WEBSITE|DOWNLOAD|BOOK_ON_WEBSITE|CALL_BUSINESS|WHATSAPP|P2B_MESSENGER|PROMO_CODE|NONE\",\n  },\n  \"thank-you-button-text\": { type: \"string\", description: \"Thank-you button text\" },\n  \"thank-you-url\": { type: \"string\", description: \"Website the thank-you button opens\" },\n  \"thank-you-phone\": { type: \"string\", description: \"CALL_BUSINESS: phone number, e.g. +14155550100\" },\n  \"thank-you-country\": { type: \"string\", description: \"CALL_BUSINESS: the number's country, e.g. US\" },\n  sharing: { type: \"string\", description: \"restricted (only people shown the ad, Meta's default) | open\" },\n  \"sms-verification\": { type: \"boolean\", description: \"Confirm the PHONE answer with a text-message code\" },\n  tracking: { type: \"string\", description: \"name=value Meta adds to every lead, repeatable\" },\n} as const;\n\nconst SCHEMA_FORM_ARGS = Object.fromEntries(\n  Object.entries(FORM_FLAG_ARGS).map(([key, arg]) => [key, { ...arg, required: false }]),\n);\n\n// --- Create ---\n\nregisterSchema({\n  command: \"ads.meta.lead-forms.create\",\n  description:\n    \"Start here to stage a Page-owned Meta Instant Form. The form is created only when this Session publishes, and it is permanent (Meta archives, never deletes). Use the returned meta_temp_* ref as --lead-form on a creative in the same Session. --file takes the whole spec (questions with keys, options, inlineContext; intro; disclaimer with checkboxes; thankYou; sharing; trackingParameters).\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"Selected Meta ad account, act_<id>\", required: true },\n    \"page-id\": {\n      type: \"string\",\n      description:\n        \"Facebook Page that owns the form — choose one with this account in promotingAccountIds and hasPageAccessToken: true from `baker ads meta pages`\",\n      required: true,\n    },\n    ...SCHEMA_FORM_ARGS,\n    file: {\n      type: \"string\",\n      description: \"JSON file with the full form payload; flags override its keys\",\n      required: false,\n    },\n  },\n});\n\nexport const leadFormsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a Meta Instant Form on a Facebook Page. ${STAGED_NOTE} The form is permanent once published (archive it to retire it).\nChoose a Page with this account in promotingAccountIds and hasPageAccessToken: true from \\`baker ads meta pages\\`.\nExample: baker ads meta lead-forms create --account-id act_123 --page-id 456 --name \"Free audit\" --questions FULL_NAME,EMAIL,PHONE --question \"Budget? => Under 1k | 1k+\" --privacy-policy-url https://example.com/privacy --follow-up-url https://example.com\nFull spec: --file form.json (see \\`baker schema ads.meta.lead-forms.create\\` and the ads-meta tool doc).`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Selected Meta ad account\" },\n    \"page-id\": { type: \"string\", description: \"Facebook Page ID\" },\n    ...FORM_FLAG_ARGS,\n    file: { type: \"string\", description: \"JSON form payload; flags override file keys\" },\n  },\n  run: async ({ args, rawArgs }) => {\n    const accountId = await bareAccountId(args as Args);\n    const payload = mergePayload(\n      formFileForStaging(loadJsonFileArg(args.file)),\n      leadFormPayloadFromFlags(args as Args, rawArgs),\n    );\n    await stageOp({ kind: \"leadForm.create\", accountId, payload }, [\n      \"An ad opens it with `creatives create --cta SIGN_UP --lead-form <ref>` into an ad set with destination ON_AD.\",\n    ]);\n  },\n});\n\n// --- Spec + duplicate ---\n\ninterface FormSpec {\n  spec: Record<string, unknown>;\n  notCopied: string[];\n  status?: string;\n}\n\nregisterSchema({\n  command: \"ads.meta.lead-forms.spec\",\n  description:\n    \"Read a live Instant Form as the exact payload `lead-forms create --file` takes — the starting point for a changed copy. Lists what could not be carried over.\",\n  args: { id: { type: \"positional\", description: \"Instant Form id\", required: true } },\n});\n\nexport const leadFormsSpecCommand = defineCommand({\n  meta: {\n    name: \"spec\",\n    description: `A live form as the payload \\`lead-forms create --file\\` / \\`lead-forms duplicate --file\\` take.\nExample: baker ads meta lead-forms spec 1460955752594831 > form.json`,\n  },\n  args: { id: { type: \"positional\", description: \"Instant Form id\", required: true } },\n  run: async ({ args }) => {\n    try {\n      const data = await apiGet<FormSpec>(\"/api/ads/meta/lead-forms/spec\", { \"form-id\": String(args.id) });\n      writeJsonEnvelope({\n        ok: true,\n        data: data.spec,\n        ...(data.notCopied.length > 0 ? { hints: [`Not carried over: ${data.notCopied.join(\"; \")}`] } : {}),\n      });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.lead-forms.duplicate\",\n  description:\n    \"Stage a NEW Instant Form copied from a live one, with changes — the only way Meta lets a form change (it keeps a form's questions, texts and settings as made). --file holds the changed keys; flags override both. Point ads at the copy, then archive the original.\",\n  args: {\n    id: { type: \"positional\", description: \"Instant Form id to copy\", required: true },\n    \"account-id\": { type: \"string\", description: \"Selected Meta ad account, act_<id>\", required: true },\n    ...SCHEMA_FORM_ARGS,\n    name: { type: \"string\", description: \"Name of the copy — unique on the Page\", required: true },\n    file: { type: \"string\", description: \"JSON with the keys to change (same shape as create)\", required: false },\n  },\n});\n\nexport const leadFormsDuplicateCommand = defineCommand({\n  meta: {\n    name: \"duplicate\",\n    description: `Stage a changed copy of a live Instant Form (Meta changes nothing on an existing form). ${STAGED_NOTE}\nExample: baker ads meta lead-forms duplicate 1460955752594831 --account-id act_123 --name \"Free audit (ES)\" --locale ES_LA\nThen point the ads at the copy (\\`creatives create --lead-form <ref>\\`) and \\`lead-forms archive <old id>\\`.`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Instant Form id to copy\", required: true },\n    \"account-id\": { type: \"string\", description: \"Selected Meta ad account\" },\n    ...FORM_FLAG_ARGS,\n    file: { type: \"string\", description: \"JSON with the keys to change\" },\n  },\n  run: async ({ args, rawArgs }) => {\n    const accountId = await bareAccountId(args as Args);\n    if (!str(args.name)) failWriteValidation(\"--name is required: Meta refuses a second form with the same name\");\n    let source: FormSpec;\n    try {\n      source = await apiGet<FormSpec>(\"/api/ads/meta/lead-forms/spec\", { \"form-id\": String(args.id) });\n    } catch (err) {\n      handleMetaError(err);\n    }\n    const flags = leadFormPayloadFromFlags(args as Args, rawArgs);\n    const payload = mergeDuplicateSpec(source.spec, formFileForStaging(loadJsonFileArg(args.file)), flags);\n    const notCopied = source.notCopied.length > 0 ? [`Not carried over: ${source.notCopied.join(\"; \")}`] : [];\n    await stageOp({ kind: \"leadForm.create\", accountId, payload }, [\n      ...notCopied,\n      `Point the ads at the copy, then \\`baker ads meta lead-forms archive ${String(args.id)}\\` to retire the original.`,\n    ]);\n  },\n});\n\n// --- Archive / unarchive ---\n\nfunction statusCommand(name: \"archive\" | \"unarchive\", status: \"ARCHIVED\" | \"ACTIVE\", description: string) {\n  registerSchema({\n    command: `ads.meta.lead-forms.${name}`,\n    description,\n    args: {\n      id: { type: \"positional\", description: \"Instant Form id\", required: true },\n      \"account-id\": { type: \"string\", description: \"Ad account the change is staged under\", required: true },\n    },\n  });\n  return defineCommand({\n    meta: {\n      name,\n      description: `${description} ${STAGED_NOTE}\nExample: baker ads meta lead-forms ${name} 1460955752594831 --account-id act_123`,\n    },\n    args: {\n      id: { type: \"positional\", description: \"Instant Form id\", required: true },\n      \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    },\n    run: async ({ args }) => {\n      await stageOp({\n        kind: \"leadForm.update\",\n        accountId: await bareAccountId(args as Args),\n        target: requireTarget(args as Args, \"Instant Form\"),\n        payload: { status },\n      });\n    },\n  });\n}\n\nexport const leadFormsArchiveCommand = statusCommand(\n  \"archive\",\n  \"ARCHIVED\",\n  \"Archive an Instant Form: it leaves the Page's form library and no ad can use it. Meta never deletes a form; this is how one is retired.\",\n);\n\nexport const leadFormsUnarchiveCommand = statusCommand(\n  \"unarchive\",\n  \"ACTIVE\",\n  \"Bring an archived Instant Form back so ads can use it again.\",\n);\n"],"mappings":"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","names":["defineCommand","defineCommand"]}

package/dist/learn-4LGNFGWH.js

@@ -0,0 +1,207 @@
+import {
+  parseDays,
+  withDefinitions
+} from "./chunk-3BOPIUO6.js";
+import {
+  setDefinitionFields
+} from "./chunk-VWKFQ4ZY.js";
+import {
+  IDEAS_DIR,
+  readIdeas
+} from "./chunk-GTIQUOYC.js";
+import "./chunk-YFIWCMVC.js";
+import "./chunk-NRMJWNX3.js";
+import "./chunk-W3PJ7V4W.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-CM2LECNX.js";
+import "./chunk-GT76FWES.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-ZPF253G5.js";
+import "./chunk-AXSSATJW.js";
+import "./chunk-DNRXEP4A.js";
+import "./chunk-OYYAR5TD.js";
+import {
+  failApi
+} from "./chunk-THV7SMY6.js";
+import "./chunk-3LH5ANM4.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-TI4UL56R.js";
+import {
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/learn.ts
+import { readFileSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+
+// src/commands/creatives/learn-model.ts
+var MIN_IMPRESSIONS = 1e3;
+var SEEN_ENOUGH = 5e3;
+var WINNER_RATIO = 0.8;
+var WINNER_MIN_RESULTS = 3;
+var FAILED_RATIO = 1.5;
+var SILENT_SPEND = 2;
+var SETTLED = /* @__PURE__ */ new Set(["winner", "failed", "inconclusive"]);
+var round = (n) => Math.round(n * 100) / 100;
+function totals(creatives) {
+  const spend = creatives.reduce((sum, c) => sum + c.spend, 0);
+  const impressions = creatives.reduce((sum, c) => sum + c.impressions, 0);
+  const results = creatives.reduce((sum, c) => sum + (c.results ?? 0), 0);
+  const clicks = creatives.reduce((sum, c) => sum + (c.ctr ?? 0) * c.impressions, 0);
+  return { spend, impressions, results, ctr: impressions > 0 ? round(clicks / impressions) : null };
+}
+function verdict(result, usual) {
+  if (result.impressions < MIN_IMPRESSIONS) return "testing";
+  if (usual !== null) {
+    if (result.results === 0 && result.spend >= SILENT_SPEND * usual) return "failed";
+    const ratio = result.vsAccount;
+    if (ratio !== null && result.results >= WINNER_MIN_RESULTS && ratio <= WINNER_RATIO) return "winner";
+    if (ratio !== null && ratio >= FAILED_RATIO) return "failed";
+  }
+  return result.impressions >= SEEN_ENOUGH ? "inconclusive" : "testing";
+}
+function ideaResult(own, usual, asOf) {
+  const mine = totals(own);
+  const costPerResult = mine.results > 0 ? round(mine.spend / mine.results) : null;
+  return {
+    asOf,
+    creatives: own.length,
+    ...own[0]?.currency ? { currency: own[0].currency } : {},
+    spend: round(mine.spend),
+    impressions: mine.impressions,
+    results: mine.results,
+    costPerResult,
+    ctr: mine.ctr,
+    vsAccount: usual !== null && costPerResult !== null ? round(costPerResult / usual) : null
+  };
+}
+function learnFromResults(ideas, creatives, asOf) {
+  const ideaOf = (c) => c.definition?.idea ?? null;
+  return ideas.flatMap((idea) => {
+    if (idea.status === "idea" || idea.status === "retired") return [];
+    const own = creatives.filter((c) => ideaOf(c) === idea.id);
+    if (own.length === 0) return [];
+    const rest = totals(creatives.filter((c) => ideaOf(c) !== idea.id));
+    const usual = rest.results > 0 ? rest.spend / rest.results : null;
+    const result = ideaResult(own, usual, asOf);
+    const to = verdict(result, usual);
+    if (to === "testing" && SETTLED.has(idea.status)) return [];
+    return [{ idea: idea.id, from: idea.status, to, result }];
+  });
+}
+
+// src/commands/creatives/learn.ts
+var DESCRIPTION = `Write back what each built idea's ads did in the live Meta account: every creative of the idea pooled, judged against the rest of the account's cost per result, and the verdict (winner, failed, inconclusive, testing) and frozen numbers written onto src/creatives/_ideas/<idea>.md. Run it before writing new ideas, and weekly.
+
+Start here:
+  baker creatives learn               # last 30 days, written onto the ideas
+  baker creatives learn --days 60
+  baker creatives learn --dry-run     # show the verdicts, write nothing
+
+A winner gets results at 0.8x the usual cost or less (3+ results); failed is 1.5x or more, or spend worth two usual results with none; under 1,000 impressions it is still testing.`;
+var ARGS = {
+  days: { type: "string", required: false, description: "Reporting window in days (default 30)" },
+  "dry-run": { type: "boolean", required: false, default: false, description: "Show the verdicts; write nothing" }
+};
+registerSchema({ command: "creatives.learn", description: DESCRIPTION, args: ARGS });
+function learnEnvelope(learnings, written, unreadable = []) {
+  const winners = learnings.filter((l) => l.to === "winner").map((l) => l.idea);
+  const failed = learnings.filter((l) => l.to === "failed").map((l) => l.idea);
+  const hints = [];
+  if (unreadable.length > 0) {
+    hints.push(
+      `Could not read ${unreadable.join(", ")}, so their results were not written: fix what \`baker creatives ideas\` names, then run this again.`
+    );
+  }
+  if (learnings.length === 0) {
+    hints.push(
+      "No built idea has ads delivering yet: nothing to learn. Ideas count once a published ad shows their creative."
+    );
+  }
+  if (winners.length > 0) {
+    hints.push(
+      `Build on ${winners.join(", ")}: keep the message and make it in a new format or for a new persona before any new idea.`
+    );
+  }
+  if (failed.length > 0) {
+    hints.push(
+      `${failed.join(", ")} lost: never repeat their message; \`baker creatives ideas\` flags an idea that does.`
+    );
+  }
+  return {
+    ok: true,
+    data: {
+      written,
+      ideas: learnings.map((l) => ({
+        idea: l.idea,
+        status: l.from === l.to ? l.to : `${l.from} \u2192 ${l.to}`,
+        ...l.result
+      }))
+    },
+    hints
+  };
+}
+async function writeBack(root, learnings) {
+  for (const learning of learnings) {
+    const file = path.join(root, IDEAS_DIR, `${learning.idea}.md`);
+    const raw = await readFile(file, "utf8");
+    await writeFile(file, setDefinitionFields(raw, { status: learning.to, result: learning.result }), "utf8");
+  }
+}
+function readDefinition(root, slug) {
+  try {
+    return readFileSync(path.join(root, "src", "creatives", slug, "_definition.md"), "utf8");
+  } catch {
+    return null;
+  }
+}
+function today() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+var learnCommand = defineCommand({
+  meta: { name: "learn", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    try {
+      const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+      const days = parseDays(args.days);
+      const performance = withDefinitions(
+        await apiPost("/api/creatives/performance", days ? { days } : {}),
+        (slug) => readDefinition(root, slug)
+      );
+      const { ideas, unreadable } = await readIdeas(root);
+      const learnings = learnFromResults(ideas, performance.data.creatives, today());
+      const dryRun = args["dry-run"] === true;
+      if (!dryRun) await writeBack(root, learnings);
+      writeJson(
+        learnEnvelope(
+          learnings,
+          !dryRun && learnings.length > 0,
+          unreadable.map((u) => u.id)
+        )
+      );
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  learnCommand,
+  learnEnvelope
+};
+//# sourceMappingURL=learn-4LGNFGWH.js.map

package/dist/library-OVX3OUYV.js

@@ -0,0 +1,211 @@
+import {
+  activeFilterFlags,
+  emptyResultHints
+} from "./chunk-Q6ULQMWG.js";
+import {
+  readOutputFlags
+} from "./chunk-35FLLWSQ.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  fullImage,
+  maskEnvelope,
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/library.ts
+import { defineCommand } from "citty";
+
+// src/commands/images/libraryRows.ts
+var LINE_CHARS = 48;
+var SUBJECT_CHARS = 120;
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function str(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function num(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function clip(text, max) {
+  return text.length <= max ? text : `${text.slice(0, max).trimEnd()}\u2026`;
+}
+function oneLine(lines) {
+  return lines.length === 0 ? null : clip(lines.join("; "), LINE_CHARS);
+}
+function peopleLine(value) {
+  if (!Array.isArray(value)) return null;
+  return oneLine(
+    value.flatMap((entry) => {
+      const person = asRecord(entry);
+      const role = str(person.role);
+      if (!role) return [];
+      const identity = str(person.identity);
+      return [identity ? `${role} \u2014 ${identity}` : role];
+    })
+  );
+}
+function textLine(value) {
+  if (!Array.isArray(value)) return null;
+  return oneLine(value.filter((line) => typeof line === "string" && line.length > 0));
+}
+function compactLibraryRow(row) {
+  const analysis = asRecord(row.analysis);
+  const description = str(row.description);
+  const score = num(row.score);
+  const entries = [
+    ["_id", String(row._id ?? "")],
+    ["name", String(row.name ?? "")],
+    ["imageUrl", String(row.imageUrl ?? "")],
+    // Placing a remote <BakerImage> needs both, or the build downloads it to measure.
+    ["width", num(row.width)],
+    ["height", num(row.height)],
+    ["subject", clip(str(analysis.subject) ?? description ?? "", SUBJECT_CHARS) || null],
+    ["brandOwnership", str(analysis.brandOwnership)],
+    ["people", peopleLine(analysis.people)],
+    ["textInImage", textLine(analysis.textInImage)],
+    ["score", score === null ? null : Math.round(score * 100) / 100],
+    ["group", row.group && typeof row.group === "object" ? row.group : null]
+  ];
+  return Object.fromEntries(entries);
+}
+function compactJsonRow(row) {
+  return Object.fromEntries(Object.entries(compactLibraryRow(row)).filter(([, value]) => value !== null));
+}
+function libraryRowNormalizer(row, full) {
+  return full ? fullImage(row) : compactLibraryRow(row);
+}
+var ROWS = "\0rows\0";
+function rowPerLine(envelope) {
+  const rows = Array.isArray(envelope.data) ? envelope.data : [];
+  const list = rows.length === 0 ? "[]" : `[
+${rows.map((row) => `    ${JSON.stringify(row)}`).join(",\n")}
+  ]`;
+  return JSON.stringify({ ...envelope, data: ROWS }, null, 2).replace(JSON.stringify(ROWS), () => list);
+}
+function writeLibraryRows(data, flags, hints) {
+  const withHints = hints.length > 0 ? { hints } : {};
+  if (flags.format === "json" && !flags.full) {
+    const compact = { ok: true, data: data.map(compactJsonRow), ...withHints };
+    process.stdout.write(`${rowPerLine(flags.fields ? maskEnvelope(compact, flags.fields) : compact)}
+`);
+    return;
+  }
+  writeOutput({ ok: true, data, ...withHints }, flags.format, flags.fields, flags.full, libraryRowNormalizer);
+}
+
+// src/commands/images/library.ts
+registerSchema({
+  command: "images.library",
+  description: "Search the company image library. Returns only ready images.",
+  args: {
+    query: { type: "string", description: "Search query text", required: true },
+    limit: { type: "number", description: "Maximum results", required: false, default: 5 },
+    "min-score": { type: "number", description: "Minimum relevance score (0-1)", required: false },
+    "aspect-ratio": {
+      type: "string",
+      description: "Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)",
+      required: false
+    },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
+    source: {
+      type: "string",
+      description: "Filter by source (uploaded, pexels, pixabay, brandfetch, google_images, firecrawl, screenshotone, iconify, giphy, \u2026)",
+      required: false
+    },
+    "external-url-host": {
+      type: "string",
+      description: "Filter to library rows whose externalUrl host contains this substring",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: {
+      type: "string",
+      description: "Comma-separated keys to keep, e.g. --fields _id,imageUrl,subject",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "The whole record (description, tags, palette, analysis) instead of the compact row",
+      required: false,
+      default: false
+    }
+  }
+});
+var libraryCommand = defineCommand({
+  meta: {
+    name: "library",
+    description: "Search the company image library (hybrid BM25 + vector + rerank). Use this BEFORE any external provider. Each hit is a compact row (_id, name, imageUrl, width, height, subject, brandOwnership, people, textInImage, score, group; empty keys left out); --full gives the whole record.\n\nStart here: baker images library 'hero banner' --aspect-ratio 16:9\nIds and URLs only: baker images library 'logo' --fields _id,imageUrl"
+  },
+  args: {
+    query: { type: "positional", description: "Search query text", required: false },
+    limit: { type: "string", description: "Max results (default 5)", required: false },
+    "min-score": { type: "string", description: "Minimum relevance score (0-1)", required: false },
+    "aspect-ratio": { type: "string", description: "Aspect ratio filter", required: false },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
+    source: { type: "string", description: "Filter by source", required: false },
+    "external-url-host": {
+      type: "string",
+      description: "Filter library by externalUrl host substring (e.g. competitor.com)",
+      required: false
+    },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: {
+      type: "string",
+      description: "Comma-separated keys to keep",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "The whole record instead of the compact row",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.limit) body.limit = Number(args.limit);
+      if (args["aspect-ratio"]) body.aspectRatio = args["aspect-ratio"];
+      if (args.tags) body.tags = args.tags.split(",").filter(Boolean);
+      if (args.source) body.source = args.source;
+      if (args["external-url-host"]) body.externalUrlHost = args["external-url-host"];
+      let data = await apiPost("/api/images/search", body);
+      const minScore = args["min-score"] ? Number(args["min-score"]) : void 0;
+      if (minScore !== void 0) {
+        data = data.filter((r) => typeof r.score === "number" && r.score >= minScore);
+      }
+      const hints = emptyResultHints({
+        provider: "library",
+        hitCount: data.length,
+        activeFilters: activeFilterFlags(args, ["aspect-ratio", "tags", "source", "external-url-host", "min-score"]),
+        subject: query
+      });
+      writeLibraryRows(data, readOutputFlags(args), hints);
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  libraryCommand
+};
+//# sourceMappingURL=library-OVX3OUYV.js.map

package/dist/lighthouse-2TDPDU7J.js

@@ -0,0 +1,75 @@
+import {
+  handleResearchError,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-UMQCYEAL.js";
+import {
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/lighthouse.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.lighthouse",
+  description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
+  args: {
+    url: { type: "string", description: "Full URL to audit (with https://)", required: true },
+    mobile: { type: "boolean", description: "Test as mobile (default: true)", required: false },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  url: "URL that was audited",
+  performance_score: "Lighthouse performance score 0-100 (aim for 90+)",
+  fcp_ms: "First Contentful Paint in ms (good: < 1800)",
+  lcp_ms: "Largest Contentful Paint in ms (good: < 2500)",
+  cls: "Cumulative Layout Shift (good: < 0.1)",
+  speed_index_ms: "Speed Index in ms (good: < 3400)",
+  interactive_ms: "Time to Interactive in ms (good: < 3800)"
+};
+var lighthouseCommand = defineCommand({
+  meta: {
+    name: "lighthouse",
+    description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
+
+Examples:
+  baker research lighthouse "https://example.com/landing"
+  baker research lighthouse "https://example.com" --mobile false`
+  },
+  args: {
+    url: { type: "positional", description: "Full URL to audit (with https://)", required: true },
+    mobile: { type: "string", description: "Test as mobile: true|false (default: true)", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const url = args.url;
+    const mobile = args.mobile === "false" ? false : void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    try {
+      const data = await apiPost("/api/research/lighthouse", {
+        url,
+        mobile,
+        skipCache
+      });
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeResearchOutput([data], format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  lighthouseCommand
+};
+//# sourceMappingURL=lighthouse-2TDPDU7J.js.map