@koda-sl/baker-cli 0.571.0-dev.6a3439a0a → 0.572.0-dev.61ba69c66

package/dist/accounts-L2HVNJUF.js

@@ -0,0 +1,76 @@
+import {
+  csvOrJson,
+  handleMetaError
+} from "./chunk-T4RV7XOC.js";
+import "./chunk-QALAJNBG.js";
+import {
+  connectedResourceHints
+} from "./chunk-P4NSJS54.js";
+import {
+  AVAILABLE_ARG,
+  writeAvailableAccounts
+} from "./chunk-OOZNTJP6.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-VF3W7CI7.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-TDUAGNSQ.js";
+import {
+  apiGet
+} from "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import "./chunk-6LUDG5AB.js";
+import "./chunk-6V4UAC5I.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/accounts.ts
+import { defineCommand } from "citty";
+function accountHints(accounts) {
+  return connectedResourceHints({
+    plural: "Meta ad accounts",
+    singular: "Meta ad account",
+    flag: "--account-id",
+    resources: accounts.flatMap((account) => {
+      const id = account.externalId ?? account.id;
+      return id ? [{ id, ...account.name ? { label: account.name } : {} }] : [];
+    })
+  });
+}
+var accountsCommand = defineCommand({
+  meta: {
+    name: "accounts",
+    description: `List Meta ad accounts in this company's connected scope.
+
+Examples:
+  baker ads meta accounts
+  baker ads meta accounts --output csv
+  baker ads meta accounts --available   # every account the login reaches, selected or not`
+  },
+  args: {
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "Output format: json|csv|jsonl|md", default: "json" },
+    available: AVAILABLE_ARG
+  },
+  run: async ({ args }) => {
+    if (args.available) return writeAvailableAccounts("meta", handleMetaError);
+    try {
+      const params = {};
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/accounts", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data, hints: accountHints(data) });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  accountsCommand
+};
+//# sourceMappingURL=accounts-L2HVNJUF.js.map

package/dist/accounts-NTBIRB52.js

@@ -0,0 +1,115 @@
+import {
+  NO_X_ACCOUNTS_EXPLANATION
+} from "./chunk-ASJMLTMX.js";
+import {
+  connectedResourceHints
+} from "./chunk-P4NSJS54.js";
+import {
+  AVAILABLE_ARG,
+  writeAvailableAccounts
+} from "./chunk-OOZNTJP6.js";
+import {
+  cacheGet,
+  cacheSet,
+  handleConnectionError,
+  needsConnectionFix,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-VF3W7CI7.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import "./chunk-6LUDG5AB.js";
+import {
+  registerSchema
+} from "./chunk-6V4UAC5I.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/accounts.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.accounts",
+  description: "List the X Ads accounts this company connected \u2014 there can be several, and every one of them is yours to work in. Returns accounts with id (base36), name, approval_status, timezone, currency. Run this first to find account IDs for other commands.",
+  args: {
+    "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" },
+    available: AVAILABLE_ARG
+  }
+});
+function accountHints(accounts) {
+  if (accounts.length === 0) return [NO_X_ACCOUNTS_EXPLANATION];
+  return connectedResourceHints({
+    plural: "X Ads accounts",
+    singular: "X Ads account",
+    flag: "--account-id",
+    resources: accounts.map((account) => ({ id: account.id, label: account.name }))
+  });
+}
+function handleAccountsError(err) {
+  if (err instanceof ApiError) {
+    if (needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("x_ads", err.message);
+    }
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: { action: "reject", explanation: err.message },
+        retryable: false
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var accountsCommand = defineCommand({
+  meta: {
+    name: "accounts",
+    description: `List accessible X Ads accounts. Returns account IDs needed for all other commands.
+
+Examples:
+  baker ads x accounts
+  baker ads x accounts --available   # every account the login reaches, selected or not`
+  },
+  args: {
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" },
+    available: AVAILABLE_ARG
+  },
+  run: async ({ args }) => {
+    if (args.available) return writeAvailableAccounts("x-ads", handleAccountsError);
+    const useCache = !args["no-cache"];
+    if (useCache) {
+      const cached = cacheGet("x-accounts", "list");
+      if (cached) {
+        writeJsonEnvelope({ ok: true, data: cached.data, cached: true, hints: accountHints(cached.data) });
+        return;
+      }
+    }
+    try {
+      const params = !useCache ? { "skip-cache": "true" } : void 0;
+      const data = await apiGet("/api/ads/x/accounts", params);
+      if (useCache) {
+        cacheSet("x-accounts", "list", data, 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data, hints: accountHints(data) });
+    } catch (err) {
+      handleAccountsError(err);
+    }
+  }
+});
+export {
+  accountsCommand
+};
+//# sourceMappingURL=accounts-NTBIRB52.js.map

package/dist/actions-N2FBJMT4.js

@@ -0,0 +1,55 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/index.ts
+import { defineCommand } from "citty";
+var actionsCommand = defineCommand({
+  meta: {
+    name: "actions",
+    description: `Manage action items for the current chat. Subcommands: list, log, draft, get, status, claim, release, create, update, complete, discard, reopen, assign, members, link, unlink.
+
+Lifecycle: claim an action before working on it. Stage create/update/complete/discard/reopen/assign/link via this CLI; they apply when the chat is published. Release if you decide not to work on it after all.
+
+Staged vs published: create/update/complete/discard/link are STAGED in this chat's draft and are invisible to \`list\`/\`status\` until the chat publishes. Review them with \`actions draft\` before finishing. To drop a staged op, use \`actions draft remove <ref>\` \u2014 never stage \`complete\` to delete a staged action (that publishes it as already-completed, leaving a duplicate).
+
+Examples:
+  baker actions list                          # bucketed view of PUBLISHED actions
+  baker actions log                            # actions COMPLETED today, with what was done (client report)
+  baker actions log --since 7d                 # everything completed in the last 7 days
+  baker actions draft                         # review what THIS chat has staged (pre-publish)
+  baker actions draft remove temp_hero         # drop a staged create (cascades its complete/link ops)
+  baker actions draft clear                    # drop everything staged in this chat
+  baker actions status temp_hero jx123         # batch resolve real IDs and temp_* refs
+  baker actions tags list                      # available tags (defaults + company custom)
+  baker actions claim <id>
+  baker actions create --name "Build hero" --tags landing,creative --description "..."
+  baker actions complete <id> --note "what changed, where, and the outcome"
+  baker actions discard <id> --reason "obsolete"
+  baker actions reopen <id>                    # a completed Task back to the backlog (on publish)
+  baker actions members                        # who a Task can be assigned to
+  baker actions assign <id> --to maria@empresa.com   # staged; --to none unassigns
+Full guide: __tooling__/docs/tools/baker/actions.md`
+  },
+  subCommands: {
+    list: () => import("./list-ONSYTCX2.js").then((m) => m.listCommand),
+    log: () => import("./log-PPNNFETI.js").then((m) => m.logCommand),
+    draft: () => import("./draft-QSTD3DH2.js").then((m) => m.draftCommand),
+    get: () => import("./get-NAOMB6Q2.js").then((m) => m.getCommand),
+    status: () => import("./status-4BSXND3I.js").then((m) => m.statusCommand),
+    claim: () => import("./claim-IGU5W4CT.js").then((m) => m.claimCommand),
+    release: () => import("./release-YL3ZII3Z.js").then((m) => m.releaseCommand),
+    create: () => import("./create-AXWJECPP.js").then((m) => m.createCommand),
+    update: () => import("./update-NG3HUYZZ.js").then((m) => m.updateCommand),
+    complete: () => import("./complete-FQNRXUI5.js").then((m) => m.completeCommand),
+    discard: () => import("./discard-K2KIIFJQ.js").then((m) => m.discardCommand),
+    reopen: () => import("./reopen-CW27MUJH.js").then((m) => m.reopenCommand),
+    assign: () => import("./assign-UMNHINRA.js").then((m) => m.assignCommand),
+    members: () => import("./members-B4UI6ISY.js").then((m) => m.membersCommand),
+    link: () => import("./link-YAZF34BZ.js").then((m) => m.linkCommand),
+    unlink: () => import("./unlink-PYCYTYVN.js").then((m) => m.unlinkCommand),
+    tags: () => import("./tags-WTN4EBT5.js").then((m) => m.tagsCommand)
+  }
+});
+export {
+  actionsCommand
+};
+//# sourceMappingURL=actions-N2FBJMT4.js.map

package/dist/active-entities-IJPRN45K.js

@@ -0,0 +1,103 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-ASJMLTMX.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson
+} from "./chunk-VF3W7CI7.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import "./chunk-6LUDG5AB.js";
+import {
+  registerSchema
+} from "./chunk-6V4UAC5I.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/active-entities.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.activeEntities",
+  description: "List entities (campaigns/line items) that had metric activity within a time range. Use this to narrow which entities to query for stats. Time range max 90 days. Times must be ISO 8601 hour-aligned.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET", required: true },
+    "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: true },
+    "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: true },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function parseCsv(v) {
+  if (typeof v !== "string" || v.length === 0) return void 0;
+  const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+var activeEntitiesCommand = defineCommand({
+  meta: {
+    name: "active-entities",
+    description: `List entities with metric activity in a time range.
+
+Examples:
+  baker ads x active-entities --account-id 18ce53xyz --entity LINE_ITEM \\
+    --start-time 2026-04-30T00:00:00Z --end-time 2026-05-07T00:00:00Z`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    entity: { type: "string", description: "CAMPAIGN | LINE_ITEM | PROMOTED_TWEET", required: true },
+    "start-time": { type: "string", description: "ISO 8601 hour-aligned start", required: true },
+    "end-time": { type: "string", description: "ISO 8601 hour-aligned end", required: true },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const body = {
+      accountId,
+      entity: args.entity,
+      startTime: args["start-time"],
+      endTime: args["end-time"],
+      fundingInstrumentIds: parseCsv(args["funding-instrument-ids"]),
+      campaignIds: parseCsv(args["campaign-ids"]),
+      lineItemIds: parseCsv(args["line-item-ids"]),
+      skipCache: !useCache || void 0
+    };
+    const cacheKey = `active-entities:${JSON.stringify(body)}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const data = await apiPost("/api/ads/x/active-entities", body);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 5 * 60 * 1e3);
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  activeEntitiesCommand
+};
+//# sourceMappingURL=active-entities-IJPRN45K.js.map