@koda-sl/baker-cli 0.554.0 → 0.556.0

package/dist/campaign-writes-Y7QNFOE7.js

@@ -0,0 +1,168 @@
+import {
+  compact,
+  microsFromArg,
+  requireTarget,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-PCUWBZM3.js";
+import "./chunk-FIN4ZXGJ.js";
+import "./chunk-H6GTG665.js";
+import "./chunk-QYH2UZAK.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/campaign-writes.ts
+import { defineCommand } from "citty";
+var BUDGET_ARGS = {
+  "daily-budget": { type: "string", description: "Daily budget in account currency, e.g. 12.50" },
+  "total-budget": { type: "string", description: "Lifetime budget in account currency \u2014 must exceed the daily budget" }
+};
+registerSchema({
+  command: "ads.x.campaigns.create",
+  description: "Stage a new X campaign on this chat's draft. Needs a funding instrument (`baker ads x funding`). Defaults to PAUSED \u2014 an ACTIVE campaign starts spending the moment the chat publishes.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    name: { type: "string", description: "Campaign name", required: true },
+    "funding-instrument-id": { type: "string", description: "From `baker ads x funding`", required: true },
+    status: { type: "string", description: "ACTIVE | PAUSED | DRAFT (default PAUSED)", required: false },
+    "daily-budget": { type: "string", description: "Daily budget in account currency", required: false },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency", required: false },
+    "budget-optimization": { type: "string", description: "CAMPAIGN | LINE_ITEM", required: false }
+  }
+});
+var campaignsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new campaign (applies when the chat is published).
+
+Examples:
+  baker ads x campaigns create --name "zz-baker-harness" --funding-instrument-id vtbot --daily-budget 5`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    name: { type: "string", description: "Campaign name", required: true },
+    "funding-instrument-id": { type: "string", description: "Funding instrument id", required: true },
+    status: { type: "string", description: "ACTIVE | PAUSED | DRAFT (default PAUSED)" },
+    ...BUDGET_ARGS,
+    "budget-optimization": { type: "string", description: "CAMPAIGN | LINE_ITEM" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "campaign.create",
+      accountId,
+      payload: compact({
+        name: args.name,
+        fundingInstrumentId: args["funding-instrument-id"],
+        entityStatus: args.status,
+        budgetOptimization: args["budget-optimization"],
+        dailyBudgetAmountLocalMicro: microsFromArg(args["daily-budget"], "--daily-budget"),
+        totalBudgetAmountLocalMicro: microsFromArg(args["total-budget"], "--total-budget")
+      })
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.campaigns.update",
+  description: "Stage a change to an existing X campaign. Staging the same campaign twice amends the staged change in place rather than queueing two writes.",
+  args: {
+    id: { type: "positional", description: "Campaign id", required: true },
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    name: { type: "string", description: "New name", required: false },
+    status: { type: "string", description: "ACTIVE | PAUSED", required: false },
+    "daily-budget": { type: "string", description: "Daily budget in account currency", required: false },
+    "total-budget": { type: "string", description: "Lifetime budget in account currency", required: false },
+    "budget-optimization": { type: "string", description: "CAMPAIGN | LINE_ITEM", required: false }
+  }
+});
+var campaignsUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Stage a change to a campaign.
+
+Examples:
+  baker ads x campaigns update oilf0 --daily-budget 20
+  baker ads x campaigns update oilf0 --name "Spring push"`
+  },
+  args: {
+    id: { type: "positional", description: "Campaign id", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" },
+    name: { type: "string", description: "New name" },
+    status: { type: "string", description: "ACTIVE | PAUSED" },
+    ...BUDGET_ARGS,
+    "budget-optimization": { type: "string", description: "CAMPAIGN | LINE_ITEM" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "campaign.update",
+      accountId,
+      target: requireTarget(args, "id"),
+      payload: compact({
+        name: args.name,
+        entityStatus: args.status,
+        budgetOptimization: args["budget-optimization"],
+        dailyBudgetAmountLocalMicro: microsFromArg(args["daily-budget"], "--daily-budget"),
+        totalBudgetAmountLocalMicro: microsFromArg(args["total-budget"], "--total-budget")
+      })
+    });
+  }
+});
+function statusCommand(name, status) {
+  registerSchema({
+    command: `ads.x.campaigns.${name}`,
+    description: `Stage ${name === "pause" ? "a pause" : "a resume"} for one or more X campaigns. Pass every id in one call.`,
+    args: {
+      ids: { type: "positional", description: "Campaign ids, comma-separated", required: true },
+      "account-id": { type: "string", description: "X Ads account ID", required: false }
+    }
+  });
+  return defineCommand({
+    meta: {
+      name,
+      description: `Stage ${name === "pause" ? "pausing" : "resuming"} campaigns.
+
+Example:
+  baker ads x campaigns ${name} oilf0,omyq3`
+    },
+    args: {
+      ids: { type: "positional", description: "Campaign ids, comma-separated", required: true },
+      "account-id": { type: "string", description: "X Ads account ID" }
+    },
+    run: async ({ args }) => {
+      const accountId = await stageAccountId(args);
+      await stageXOps(
+        requireTargets(args, "ids").map((id) => ({
+          kind: "campaign.update",
+          accountId,
+          target: id,
+          payload: { entityStatus: status }
+        }))
+      );
+    }
+  });
+}
+var campaignsPauseCommand = statusCommand("pause", "PAUSED");
+var campaignsResumeCommand = statusCommand("resume", "ACTIVE");
+export {
+  campaignsCreateCommand,
+  campaignsPauseCommand,
+  campaignsResumeCommand,
+  campaignsUpdateCommand
+};
+//# sourceMappingURL=campaign-writes-Y7QNFOE7.js.map

package/dist/campaigns-2Z6WXIVA.js

@@ -0,0 +1,130 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  budgetUnitHints,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-ZW2CN6L6.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-QY7EK6Q4.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-QYH2UZAK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-65Y3RCWP.js";
+import {
+  apiGet
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/campaigns.ts
+import { defineCommand } from "citty";
+function advantagePlusHints(rows) {
+  const named = rows.flatMap((row) => {
+    const info = row.advantage_state_info;
+    const state = info?.advantage_state;
+    return typeof state === "string" && state.startsWith("ADVANTAGE_PLUS_") ? [`${String(row.id)} (${state.slice("ADVANTAGE_PLUS_".length).toLowerCase()})`] : [];
+  });
+  return named.length > 0 ? [
+    `Advantage+ campaigns: ${named.join(", ")}. Per-lever states (budget, audience, placements): --fields id,name,advantage_state_info.`
+  ] : [];
+}
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter and return everything" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  ...META_LIST_SHAPE_ARGS
+};
+registerMetaListSchema(
+  "campaigns",
+  "List campaigns in a Meta ad account, as a table by default: id, name, effective_status, daily_budget, lifetime_budget, created_date. ACTIVE only unless --all-statuses. Start here: baker ads meta campaigns --account-id act_123 --all-statuses. --fields takes dotted paths for anything else (e.g. id,name,objective,bid_strategy,special_ad_categories,advantage_state_info); --full returns every field Meta sent; --output json returns the rows in the envelope. A hint names the campaigns Meta counts as Advantage+.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List campaigns for a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta campaigns --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = await resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args["name-contains"]) params["name-contains"] = args["name-contains"];
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/campaigns", params);
+      const shaped = shapeMetaListRows("campaigns", data, args);
+      writeMetaListRows("campaigns", shaped, csvOrJson(args), [
+        ...statusFilterHints(data, effectiveStatus, "campaigns"),
+        ...advantagePlusHints(data),
+        ...budgetUnitHints(data)
+      ]);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `List campaigns for a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/copy).
+Defaults to ACTIVE only \u2014 pass --all-statuses to widen. Write subcommands stage ops on this chat's draft and
+apply only when the chat is published.
+
+In Meta's API "campaign" is the top-of-tree object (what marketers usually call a campaign group).
+The dashboard shows effective_status: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, etc.
+
+Listings print a table by default: id, name, effective_status, daily/lifetime budget, created_date.
+--fields takes dotted paths for anything else (objective, bid_strategy, special_ad_categories, created_time,
+advantage_state_info). A hint names the campaigns Meta counts as Advantage+ \u2014 a state Meta derives from a
+campaign budget, Advantage+ audience and automatic placements on every ad set, not a setting;
+--full returns every field; --output json returns the same rows in the { ok, data } envelope.
+
+Examples:
+  baker ads meta campaigns --account-id act_123                                   # ACTIVE only
+  baker ads meta campaigns --account-id act_123 --all-statuses                    # everything
+  baker ads meta campaigns --account-id act_123 --all-statuses --name-contains Q3               # find one by name
+  baker ads meta campaigns --account-id act_123 --fields id,name,objective,bid_strategy,special_ad_categories
+  baker ads meta campaigns --account-id act_123 --output json                     # rows as JSON
+  baker ads meta campaigns create --account-id act_123 --name "Q3" --objective OUTCOME_LEADS --daily-budget 50
+  baker ads meta campaigns pause 6123 --account-id act_123`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-F5XPPLOO.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-F5XPPLOO.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-F5XPPLOO.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-F5XPPLOO.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-F5XPPLOO.js").then((m) => m.campaignsArchiveCommand),
+    delete: () => import("./write-commands-F5XPPLOO.js").then((m) => m.campaignsDeleteCommand),
+    duplicate: () => import("./write-commands-F5XPPLOO.js").then((m) => m.campaignsDuplicateCommand),
+    copy: () => import("./copy-writes-2B36QJUY.js").then((m) => m.campaignsCopyCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  advantagePlusHints,
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-2Z6WXIVA.js.map

package/dist/campaigns-B2AUW4TV.js

@@ -0,0 +1,111 @@
+import {
+  xMicrosHints
+} from "./chunk-MKAYMOZY.js";
+import {
+  runListCommand
+} from "./chunk-CQMAR4BH.js";
+import "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-H6GTG665.js";
+import "./chunk-QYH2UZAK.js";
+import "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/campaigns.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.campaigns",
+  description: "List campaigns for an X Ads account. Optionally filter by funding-instrument-ids or campaign-ids (comma-separated). Includes deleted with --with-deleted. Falls back to BAKER_X_ADS_ACCOUNT_ID.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted campaigns", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  }
+});
+var listArgs = {
+  "account-id": { type: "string", description: "X Ads account ID" },
+  "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs" },
+  "campaign-ids": { type: "string", description: "CSV of campaign IDs" },
+  "with-deleted": { type: "boolean", description: "Include deleted" },
+  "no-cache": { type: "boolean", description: "Skip cache" },
+  output: { type: "string", description: "Format: json|csv|md", default: "json" }
+};
+var campaignsListCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `List X Ads campaigns. Returns budget, schedule, funding instrument, status.
+
+Examples:
+  baker ads x campaigns --account-id 18ce53xyz
+  baker ads x campaigns --account-id 18ce53xyz --campaign-ids abc,def
+  baker ads x campaigns --account-id 18ce53xyz --with-deleted`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const cacheKey = `campaigns:${accountId}:${today}:${args["funding-instrument-ids"] ?? ""}:${args["campaign-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+    await runListCommand({
+      path: "/api/ads/x/campaigns",
+      cacheCategory: "x-account-data",
+      cacheKey,
+      cacheTtlMs: 60 * 60 * 1e3,
+      params: {
+        "account-id": accountId,
+        "funding-instrument-ids": args["funding-instrument-ids"],
+        "campaign-ids": args["campaign-ids"],
+        "with-deleted": args["with-deleted"] ? "true" : void 0
+      },
+      format: args.output || "json",
+      accountId,
+      useCache,
+      hintsFor: xMicrosHints
+    });
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `X Ads campaigns \u2014 read them, or stage a change that applies when the chat is published.
+
+Write subcommands stage ops on this chat's draft. They never call X directly.
+
+Examples:
+  baker ads x campaigns
+  baker ads x campaigns create --name "Spring" --funding-instrument-id vtbot --daily-budget 5
+  baker ads x campaigns update oilf0 --daily-budget 20
+  baker ads x campaigns pause oilf0,omyq3`
+  },
+  subCommands: {
+    list: campaignsListCommand,
+    create: () => import("./campaign-writes-Y7QNFOE7.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./campaign-writes-Y7QNFOE7.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./campaign-writes-Y7QNFOE7.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./campaign-writes-Y7QNFOE7.js").then((m) => m.campaignsResumeCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it AFTER the
+  // matched subcommand, so every write would also trigger a full live list.
+  args: listArgs,
+  default: "list"
+});
+export {
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-B2AUW4TV.js.map

package/dist/campaigns-IDEA3LOK.js

@@ -0,0 +1,113 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-OTFHIGEO.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-QYH2UZAK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiGet
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/campaigns.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" },
+  "campaign-group-id": { type: "string", description: "Filter by campaign group" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  statuses: { type: "string", description: statusesArgDescription("campaigns") },
+  limit: { type: "string", description: "Max rows (default: 500)" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+};
+var campaignsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List LinkedIn campaigns. Runs by default when no subcommand is given."
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      const statuses = resolveStatusFilter(args, "campaigns");
+      if (statuses) params.statuses = statuses.join(",");
+      if (args["campaign-group-id"]) params["campaign-group-id"] = String(args["campaign-group-id"]);
+      if (args.limit) params.limit = String(args.limit);
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/campaigns", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `List LinkedIn campaigns, or stage writes (create/update/pause/resume/archive/duplicate).
+
+Default: ACTIVE only. The schema includes the audit-relevant settings:
+  audienceExpansionEnabled \u2014 playbook \xA702 silent budget drain (should be false)
+  offsiteDeliveryEnabled   \u2014 LinkedIn Audience Network gate
+  optimizationTargetType   \u2014 driver of the bidding strategy
+  costType                 \u2014 CPC | CPM | CPV | CPS
+
+Write subcommands stage ops on this chat's draft \u2014 they never hit the LinkedIn
+API directly and apply only when the chat is published.
+
+Examples:
+  baker ads linkedin campaigns --account-id 503001492
+  baker ads linkedin campaigns --account-id 503001492 --all-statuses --output csv
+  baker ads linkedin campaigns update 123456 --daily-budget 100 --currency EUR
+  baker ads linkedin campaigns pause 123456
+  baker ads linkedin campaigns url-params 123456 --param utm_source=linkedin   \u2014 UTMs for every ad in the ad set
+  baker ads linkedin campaigns exclude-companies 123456 --org 1035,1441        \u2014 stop reaching these companies`
+  },
+  subCommands: {
+    list: campaignsListCommand,
+    create: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.campaignsArchiveCommand),
+    duplicate: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.campaignsDuplicateCommand),
+    delete: () => import("./write-commands-3U5ZMIHH.js").then((m) => m.campaignsDeleteCommand),
+    "url-params": () => import("./write-commands-3U5ZMIHH.js").then((m) => m.campaignsUrlParamsCommand),
+    "exclude-companies": () => import("./write-commands-3U5ZMIHH.js").then((m) => m.campaignsExcludeCompaniesCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it *after* running
+  // the matched subcommand, so every write would also trigger a full live list.
+  // `args` stays here so citty's subcommand scan knows which flags take a value.
+  args: listArgs,
+  default: "list"
+});
+export {
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-IDEA3LOK.js.map

package/dist/canvas-PVNQ7YWV.js

@@ -0,0 +1,46 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/index.ts
+import { defineCommand } from "citty";
+var canvasCommand = defineCommand({
+  meta: {
+    name: "canvas",
+    description: `Run Baker creative canvas JSON files locally. Local nodes execute in-process; remote nodes POST to the Convex backend gateway.
+
+Auth: BAKER_API_KEY (bk_, bkr_ or bkv_) + BAKER_API_URL (your Convex .convex.site URL).
+
+Subcommands:
+  baker canvas validate <file.json> : bring the canvas up to date with its blueprint, then schema/registry check + composition-meta deep check + cost preview
+  baker canvas critique <file.json> : pre-spend creative critic (advisory): video hook/legibility/retention or static text/grounding/type scores, never blocks
+  baker canvas viewer-check <slug> : would the viewer this static ad reaches understand it? (what is offered, to whom, what next; run makes the same check before it spends)
+  baker canvas run <file.json> : execute the canvas, write outputs to ./canvas/<run_id>/
+  baker canvas run --slug <slug> : run a creative by name; restores its files from run history when this workspace lacks them
+  baker canvas stale : creatives edited since their last render here (re-render each one listed)
+  baker canvas sync-definition <path> : push a creative's current node-graph + input thumbnails to the dashboard without rendering (runs automatically on canvas/prompt edits)
+  baker canvas catalog : one line per node; --node <id> for its full schema
+  baker canvas inspect <run_id> : one-page summary of a run (from run history when its folder is not here)
+  baker canvas scaffold-ad --spec <spec.json> : DEFAULT for a new ad: write beats (one spoken line + one shot each), get the whole runnable canvas
+  baker canvas scaffold-video <video> : reproduce a video the USER gave you (an ad you found is inspiration, not a copy target)
+  baker canvas scaffold-static-ad <image> : turn a source image into a runnable static-ad canvas (describe + element detection)
+Full guide: __tooling__/docs/tools/baker/canvas.md`
+  },
+  subCommands: {
+    run: () => import("./run-3GCYZ2HX.js").then((m) => m.runCommand),
+    rerun: () => import("./rerun-X7XVOAL3.js").then((m) => m.rerunCommand),
+    validate: () => import("./validate-44PVFQH7.js").then((m) => m.validateCommand),
+    critique: () => import("./critique-PQRVFC52.js").then((m) => m.critiqueCommand),
+    "viewer-check": () => import("./viewer-check-KTRRUVZN.js").then((m) => m.viewerCheckCommand),
+    catalog: () => import("./catalog-URTZYAPU.js").then((m) => m.catalogCommand),
+    inspect: () => import("./inspect-BM6GJHQV.js").then((m) => m.inspectCommand),
+    "scaffold-ad": () => import("./scaffold-ad-E6DD6U46.js").then((m) => m.scaffoldAdCommand),
+    "scaffold-video": () => import("./scaffold-video-QKXFQ5FC.js").then((m) => m.scaffoldVideoCommand),
+    "scaffold-static-ad": () => import("./scaffold-static-ad-6WNS2PXB.js").then((m) => m.scaffoldStaticAdCommand),
+    "set-prompt": () => import("./set-prompt-5LYHDT4E.js").then((m) => m.setPromptCommand),
+    "sync-definition": () => import("./sync-definition-MXVL2I2H.js").then((m) => m.syncDefinitionCommand),
+    stale: () => import("./stale-MLQPXNLZ.js").then((m) => m.staleCommand)
+  }
+});
+export {
+  canvasCommand
+};
+//# sourceMappingURL=canvas-PVNQ7YWV.js.map