@koda-sl/baker-cli 0.470.0 → 0.472.0

package/dist/setup-links-DG2JGU6C.js

@@ -0,0 +1,141 @@
+import {
+  repeatedFlagValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  failApi,
+  failValidation
+} from "./chunk-3YPRJNES.js";
+import "./chunk-XABVEMC3.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-QG2WPVKE.js";
+import "./chunk-TSOJM4EO.js";
+import "./chunk-5TTHWWON.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/setup-links/index.ts
+import { defineCommand } from "citty";
+var DOC = "__tooling__/docs/tools/baker/setup-links.md";
+var CREATE_HINT = "Send this link to whoever owns the accounts; it works without a Baker login and expires in 30 days. Revoke it in Settings \u2192 Setup links.";
+var LIST_FLAGS = ["tags", "connect", "keys", "apps", "domains"];
+var FLAG_HELP = {
+  tags: "Tracking tags to add (repeatable or comma-separated): meta, googleAds, googleAnalytics, linkedinInsightTag, tiktok, \u2026",
+  connect: "Accounts to connect by signing in (repeatable or comma-separated): google-ads, meta, google-analytics, google-tag-manager, google-search-console, linkedin, x-ads, hubspot, \u2026",
+  keys: "Accounts connected by pasting a key (repeatable or comma-separated): chatgpt-ads",
+  apps: "Apps from the app catalog, by slug or exact name (repeatable or comma-separated): slack, notion, \u2026 Find one with `baker mcp catalog <search>`.",
+  mcp: "An MCP server to connect, as name=https://address (repeatable). The recipient types any key into the link, never you.",
+  domains: "The company's own domain whose DNS record the recipient sets, by hostname (repeatable or comma-separated). It must already be added to Baker."
+};
+registerSchema({
+  command: "setup-links.create",
+  description: "Start here: make a setup link for whoever holds the company's accounts (an agency, the client's IT) \u2014 they open it, no Baker login needed, and connect what it asks for. Example: baker setup-links create --connect google-ads --tags meta. Made at once and returned now with its url: send it back to the user in this reply. Unknown names are refused: tags, connections and keys with the list of valid ones, apps with a pointer to `baker mcp catalog`.",
+  args: {
+    tags: { type: "string", description: FLAG_HELP.tags, required: false },
+    connect: { type: "string", description: FLAG_HELP.connect, required: false },
+    keys: { type: "string", description: FLAG_HELP.keys, required: false },
+    apps: { type: "string", description: FLAG_HELP.apps, required: false },
+    mcp: { type: "string", description: FLAG_HELP.mcp, required: false },
+    domains: { type: "string", description: FLAG_HELP.domains, required: false }
+  }
+});
+registerSchema({
+  command: "setup-links.list",
+  description: "The company's setup links that still work: what each asks for (in the same words `create` takes), how much of it is done, its url and when it expires. Check it before making a link that already exists.",
+  args: {}
+});
+function listFlag(rawArgs, flag) {
+  return repeatedFlagValues(rawArgs, flag).flatMap((value) => value.split(",")).map((value) => value.trim()).filter((value) => value !== "");
+}
+function createBody(rawArgs) {
+  const body = {};
+  for (const flag of LIST_FLAGS) {
+    const values = listFlag(rawArgs, flag);
+    if (values.length > 0) body[flag] = values;
+  }
+  const mcp = [];
+  for (const raw of repeatedFlagValues(rawArgs, "mcp")) {
+    const separator = raw.indexOf("=");
+    const name = raw.slice(0, separator).trim();
+    const url = raw.slice(separator + 1).trim();
+    if (separator < 0 || name === "" || !/^https:\/\//.test(url)) {
+      return { ok: false, error: `--mcp takes name=https://address, got "${raw}".` };
+    }
+    mcp.push({ name, url });
+  }
+  if (mcp.length > 0) body.mcp = mcp;
+  if (Object.keys(body).length === 0) {
+    return {
+      ok: false,
+      error: "A setup link has to ask for something: pass --tags, --connect, --keys, --apps, --mcp or --domains."
+    };
+  }
+  return { ok: true, body };
+}
+var createCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Make a setup link for whoever holds the company's accounts; returns its url now.
+Start here: baker setup-links create --connect google-ads --tags meta`
+  },
+  args: {
+    tags: { type: "string", description: FLAG_HELP.tags, required: false },
+    connect: { type: "string", description: FLAG_HELP.connect, required: false },
+    keys: { type: "string", description: FLAG_HELP.keys, required: false },
+    apps: { type: "string", description: FLAG_HELP.apps, required: false },
+    mcp: { type: "string", description: FLAG_HELP.mcp, required: false },
+    domains: { type: "string", description: FLAG_HELP.domains, required: false }
+  },
+  run: async ({ rawArgs }) => {
+    const parsed = createBody(rawArgs);
+    if (!parsed.ok) {
+      failValidation(parsed.error);
+    }
+    try {
+      const response = await apiPost("/api/setup-links/create", parsed.body);
+      writeJson({ ok: true, data: response.data, hints: [CREATE_HINT] });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "The company's setup links that still work: what each asks for, progress, url and expiry."
+  },
+  args: {},
+  run: async () => {
+    try {
+      const response = await apiPost("/api/setup-links/list", {});
+      writeJson({
+        ok: true,
+        data: response.data,
+        meta: { count: response.data.links.length },
+        ...response.data.links.length === 0 ? { hints: ["No setup links are out. Make one with baker setup-links create."] } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var setupLinksCommand = defineCommand({
+  meta: {
+    name: "setup-links",
+    description: `Setup links: one link that lets whoever holds the company's accounts connect them, without a Baker login. Subcommands: create, list.
+Full guide: ${DOC}`
+  },
+  subCommands: { create: createCommand, list: listCommand }
+});
+export {
+  createBody,
+  setupLinksCommand
+};
+//# sourceMappingURL=setup-links-DG2JGU6C.js.map

package/dist/shared-3RWMU7M7.js

@@ -0,0 +1,31 @@
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  daysAgoIso,
+  getDateRange,
+  handleMetaError,
+  metaForbiddenFix,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints,
+  todayIso
+} from "./chunk-HR3HS56F.js";
+import "./chunk-CXT6Q7KP.js";
+import "./chunk-QG2WPVKE.js";
+import "./chunk-TSOJM4EO.js";
+import "./chunk-5TTHWWON.js";
+import "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  daysAgoIso,
+  getDateRange,
+  handleMetaError,
+  metaForbiddenFix,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints,
+  todayIso
+};
+//# sourceMappingURL=shared-3RWMU7M7.js.map

package/dist/site-CYFE737S.js

@@ -0,0 +1,177 @@
+import {
+  SiteArgsError,
+  failSite,
+  parseSetArgs
+} from "./chunk-AZ3AQXCA.js";
+import "./chunk-XABVEMC3.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-QG2WPVKE.js";
+import "./chunk-TSOJM4EO.js";
+import {
+  optionalChatId,
+  requireChatId
+} from "./chunk-5TTHWWON.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/site/index.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "site.show",
+  description: "Start here: the company's site settings as they will be after this chat publishes \u2014 cookie consent (consent), what Baker records (analyticsCollection), search engines (indexing), the home page (homePage, null = the first published landing), time zone, download format (exportProfile, null = default) and custom domains with their status \u2014 plus `staged`: what this chat changed, each with before/after. Hints name other open chats that already staged a site setting. Read-only.",
+  args: {
+    chat: {
+      type: "string",
+      description: "Read another chat's staged settings instead of this chat's (a chat id from `baker chats list`)",
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "site.set",
+  description: "Stage one or more site settings in one call; all apply when the chat is published, none mid-chat. Combine flags freely: `baker site set --consent recovery --indexing on`. Restaging a setting replaces what this chat staged before. Any member's chat may change these \u2014 the person who publishes is the review. --consent: bypass (no banner, maximum tracking), recovery (banner; declines still send anonymized pings \u2014 the usual EU choice), strict (banner; declines send nothing), external (the site's own consent tool). --collection: full, aggregate (counts only, nobody identifiable), off (Baker records nothing). --home takes a published landing slug (or one this chat is building); \"none\" restores the default. Always ask the user before hiding the site from search engines or reducing what Baker records.",
+  args: {
+    consent: { type: "string", description: "bypass | recovery | strict | external", required: false },
+    collection: { type: "string", description: "full | aggregate | off", required: false },
+    payloads: {
+      type: "string",
+      description: "on | off \u2014 keep a copy of each lead (only with --collection full)",
+      required: false
+    },
+    indexing: { type: "string", description: "on | off \u2014 show the site in search engines", required: false },
+    home: { type: "string", description: "Landing slug to serve at the site root, or none", required: false },
+    "home-mode": {
+      type: "string",
+      description: "rewrite (default; the root shows the landing) | redirect (the root sends visitors to /<slug>)",
+      required: false
+    },
+    timezone: { type: "string", description: "IANA time zone, e.g. Europe/Madrid", required: false },
+    "export-profile": {
+      type: "string",
+      description: 'Only the download-format fields to change, as JSON (e.g. {"htmlOutput":"fragment"}) or @path/to/profile.json. A second call adds to the first; Publish lays them over the format saved then',
+      required: false
+    }
+  }
+});
+registerSchema({
+  command: "site.unstage",
+  description: "Take back a site setting this chat staged, before publish \u2014 the same as discarding its row in the chat's Settings review. The key is the setting (consent, analyticsCollection, indexing, homePage, timezone, exportProfile) or customDomain:<hostname>; --all takes back every one. Never touches what is already live.",
+  args: {
+    key: { type: "string", description: "A `key` from `baker site show` \u2192 staged", required: false },
+    all: { type: "boolean", description: "Take back every staged site setting", required: false }
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show the site settings as they will be after this chat publishes, and what this chat staged.\n\nExample: baker site show"
+  },
+  args: {
+    chat: { type: "string", description: "Another chat's id, to read what it staged", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = typeof args.chat === "string" && args.chat.length > 0 ? args.chat : optionalChatId();
+      writeJson(await apiGet("/api/site", chatId ? { chatId } : void 0));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var setCommand = defineCommand({
+  meta: {
+    name: "set",
+    description: "Stage site settings; they apply when the chat is published.\n\nExamples:\n  baker site set --consent recovery\n  baker site set --collection aggregate\n  baker site set --indexing off\n  baker site set --home oferta --home-mode redirect\n  baker site set --home none\n  baker site set --timezone Europe/Madrid\n  baker site set --export-profile @profile.json"
+  },
+  args: {
+    consent: { type: "string", description: "bypass | recovery | strict | external", required: false },
+    collection: { type: "string", description: "full | aggregate | off", required: false },
+    payloads: { type: "string", description: "on | off (with --collection full)", required: false },
+    indexing: { type: "string", description: "on | off", required: false },
+    home: { type: "string", description: "Landing slug, or none", required: false },
+    "home-mode": { type: "string", description: "rewrite | redirect", required: false },
+    timezone: { type: "string", description: "IANA time zone", required: false },
+    "export-profile": {
+      type: "string",
+      description: "Fields to change, as JSON or @path; added to any staged earlier, laid over the saved format at Publish",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const inputs = parseSetArgs(
+        {
+          consent: args.consent,
+          collection: args.collection,
+          payloads: args.payloads,
+          indexing: args.indexing,
+          home: args.home,
+          "home-mode": args["home-mode"],
+          timezone: args.timezone,
+          "export-profile": args["export-profile"]
+        },
+        (path) => readFileSync(path, "utf8")
+      );
+      const body = { chatId: requireChatId(), inputs };
+      writeJson(await apiPost("/api/site/stage", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var unstageCommand = defineCommand({
+  meta: {
+    name: "unstage",
+    description: "Take back a staged site setting before publish.\n\nExamples:\n  baker site unstage consent\n  baker site unstage customDomain:shop.acme.com\n  baker site unstage --all"
+  },
+  args: {
+    key: { type: "positional", description: "The setting key from `baker site show` \u2192 staged", required: false },
+    all: { type: "boolean", description: "Take back every staged site setting", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const key = typeof args.key === "string" && args.key.length > 0 ? args.key : void 0;
+      if (key === void 0 === (args.all !== true)) {
+        throw new SiteArgsError("Pass one setting key (see `baker site show` \u2192 staged) or --all.");
+      }
+      const body = { chatId: requireChatId(), ...key ? { key } : { all: true } };
+      writeJson(await apiPost("/api/site/draft-op/remove", body));
+    } catch (err) {
+      failSite(err);
+    }
+  }
+});
+var siteCommand = defineCommand({
+  meta: {
+    name: "site",
+    description: `The company's site settings: cookie consent, what Baker records, search engines, home page, time zone, landing download format, custom domains. Every change stages on this chat and applies when it is published. Subcommands: show, set, unstage, domain.
+
+Examples:
+  baker site show
+  baker site set --consent recovery --indexing on
+  baker site set --home oferta
+  baker site domain add shop.acme.com
+  baker site unstage homePage
+Full guide: __tooling__/docs/tools/baker/site.md`
+  },
+  subCommands: {
+    show: showCommand,
+    set: setCommand,
+    unstage: unstageCommand,
+    domain: () => import("./domain-5ZTGG6OK.js").then((m) => m.domainCommand)
+  }
+});
+export {
+  siteCommand
+};
+//# sourceMappingURL=site-CYFE737S.js.map

package/dist/sitemaps-EDRVQLPY.js

@@ -0,0 +1,87 @@
+import {
+  resolveSiteUrl
+} from "./chunk-YLD5KYSV.js";
+import {
+  cacheGet,
+  cacheSet,
+  handleConnectionError,
+  isNotConnectedError,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-CXT6Q7KP.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-QG2WPVKE.js";
+import "./chunk-TSOJM4EO.js";
+import "./chunk-5TTHWWON.js";
+import {
+  registerSchema
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/gsc/sitemaps.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "gsc.sitemaps",
+  description: "List sitemaps for a Search Console site. Check sitemap health and errors.",
+  args: {
+    "site-url": { type: "string", description: "Site URL (auto-resolved if not provided)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
+  }
+});
+var sitemapsCommand = defineCommand({
+  meta: {
+    name: "sitemaps",
+    description: `List sitemaps for a site. Check health and errors.
+
+Examples:
+  baker gsc sitemaps
+  baker gsc sitemaps --site-url "https://example.com/"`
+  },
+  args: {
+    "site-url": { type: "string", description: "Site URL", 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 siteUrl = await resolveSiteUrl(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `sitemaps:${siteUrl}`;
+    if (useCache) {
+      const cached = cacheGet("gsc-sitemaps", cacheKey);
+      if (cached) {
+        writeJsonEnvelope({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "site-url": siteUrl };
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/gsc/sitemaps", params);
+      if (useCache) {
+        cacheSet("gsc-sitemaps", cacheKey, data, 6 * 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        if (isNotConnectedError(err.code, err.message)) {
+          handleConnectionError("gsc", err.message);
+        }
+        writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  sitemapsCommand
+};
+//# sourceMappingURL=sitemaps-EDRVQLPY.js.map

package/dist/sites-VR7MJOOS.js

@@ -0,0 +1,101 @@
+import {
+  connectedResourceHints
+} from "./chunk-P4NSJS54.js";
+import {
+  AVAILABLE_ARG,
+  writeAvailableAccounts
+} from "./chunk-MEE6QVOG.js";
+import {
+  cacheGet,
+  cacheSet,
+  handleConnectionError,
+  needsConnectionFix,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-CXT6Q7KP.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-QG2WPVKE.js";
+import "./chunk-TSOJM4EO.js";
+import "./chunk-5TTHWWON.js";
+import {
+  registerSchema
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/gsc/sites.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "gsc.sites",
+  description: "List the Search Console sites this company connected \u2014 there can be several, and every one of them is yours to query. Returns the site URLs the query and sitemaps commands take.",
+  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 siteHints(sites) {
+  return connectedResourceHints({
+    plural: "Search Console sites",
+    singular: "Search Console site",
+    flag: "--site-url",
+    resources: sites.map((site) => ({ id: site.siteUrl, label: site.permissionLevel }))
+  });
+}
+function handleListError(err) {
+  if (err instanceof ApiError) {
+    if (needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("gsc", err.message);
+    }
+    writeJsonEnvelope({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var sitesCommand = defineCommand({
+  meta: {
+    name: "sites",
+    description: `List verified Search Console sites.
+
+Examples:
+  baker gsc sites
+  baker gsc sites --available   # everything 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("google-search-console", handleListError);
+    const useCache = !args["no-cache"];
+    if (useCache) {
+      const cached = cacheGet("gsc-sites", "list");
+      if (cached) {
+        writeJsonEnvelope({ ok: true, data: cached.data, cached: true, hints: siteHints(cached.data) });
+        return;
+      }
+    }
+    try {
+      const params = !useCache ? { "skip-cache": "true" } : void 0;
+      const data = await apiGet("/api/gsc/sites", params);
+      if (useCache) {
+        cacheSet("gsc-sites", "list", data, 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data, hints: siteHints(data) });
+    } catch (err) {
+      handleListError(err);
+    }
+  }
+});
+export {
+  sitesCommand
+};
+//# sourceMappingURL=sites-VR7MJOOS.js.map

package/dist/skills-VEKPSC65.js

@@ -0,0 +1,47 @@
+import {
+  failStudioCommand
+} from "./chunk-JCWH3JM6.js";
+import {
+  apiGet
+} from "./chunk-QG2WPVKE.js";
+import "./chunk-TSOJM4EO.js";
+import "./chunk-5TTHWWON.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/skills.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "studio.skills",
+  description: "The craft directions `studio generate --skill <id>` accepts. Each one carries directed art direction plus the model, shape and take count it wants, so you pick a look by name instead of writing the boilerplate yourself.",
+  args: {}
+});
+var skillsCommand = defineCommand({
+  meta: {
+    name: "skills",
+    description: "List the craft directions available to `baker studio generate --skill <id>` \u2014 what each one is for, whether it wants a reference image, and the model/shape/count it defaults to.\n\nExample: baker studio skills"
+  },
+  args: {},
+  run: async () => {
+    try {
+      const { skills } = await apiGet("/api/studio/skills");
+      writeJson({
+        ok: true,
+        data: skills,
+        meta: { count: skills.length },
+        hints: skills.some((skill) => skill.wantsReference) ? [
+          "A skill marked wantsReference is built around real imagery \u2014 pass `--reference` with a product shot, logo, or mood image or it will invent the subject."
+        ] : []
+      });
+    } catch (error) {
+      failStudioCommand(error);
+    }
+  }
+});
+export {
+  skillsCommand
+};
+//# sourceMappingURL=skills-VEKPSC65.js.map