@koda-sl/baker-cli 0.534.0-dev.911a80433 → 0.534.0

package/dist/chunk-L4LNS54Y.js

@@ -0,0 +1,138 @@
+import {
+  cacheGet,
+  cacheSet,
+  handleConnectionError,
+  needsConnectionFix,
+  writeJsonEnvelope
+} from "./chunk-LV7EU6HM.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-CIW3Q7B2.js";
+import {
+  getEnv,
+  optionalTargetCompany
+} from "./chunk-VPF5A7CM.js";
+
+// src/commands/gsc/errors.ts
+var RETRYABLE_CODES = /* @__PURE__ */ new Set(["RATE_LIMITED", "UNAVAILABLE", "INTERNAL_ERROR", "NETWORK_ERROR", "TIMEOUT"]);
+function handleGscError(err) {
+  if (!(err instanceof ApiError)) {
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "NETWORK_ERROR",
+        message: err instanceof Error ? err.message : "Unexpected error",
+        retryable: true
+      }
+    });
+    process.exit(1);
+  }
+  if (needsConnectionFix(err.code, err.message)) {
+    handleConnectionError("gsc", err.message);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: err.code, message: err.message, retryable: RETRYABLE_CODES.has(err.code) }
+  });
+  process.exit(1);
+}
+
+// src/commands/gsc/resolve.ts
+function isReadableSite(site) {
+  return site.permissionLevel !== "siteUnverifiedUser";
+}
+async function handleGscSiteError(err, refusedSiteUrl) {
+  if (!(err instanceof ApiError) || err.code !== "FORBIDDEN" || !/permission/i.test(err.message)) {
+    return handleGscError(err);
+  }
+  let sites;
+  try {
+    sites = await fetchSites(false);
+  } catch {
+    return handleGscError(err);
+  }
+  const readable = sites.filter((site) => isReadableSite(site) && site.siteUrl !== refusedSiteUrl).map((site) => site.siteUrl);
+  writeJsonEnvelope({
+    ok: false,
+    error: {
+      code: err.code,
+      message: err.message,
+      retryable: false,
+      fix: readable.length > 0 ? useReadableSiteFix(readable) : noReadableSiteFix()
+    }
+  });
+  process.exit(1);
+}
+function useReadableSiteFix(readable) {
+  return {
+    action: "use_readable_site",
+    explanation: `The Google account connected to Search Console cannot read this site. Retrying will not help. Run the same read with --site-url set to one of: ${readable.join(", ")}.`,
+    validValues: readable
+  };
+}
+function noReadableSiteFix() {
+  if (optionalTargetCompany()) {
+    return {
+      action: "continue_without",
+      explanation: "The Google account connected to Search Console for that company cannot read any of its sites. It can only be reconnected in that company's own workspace, never with `request_connection` from here. Show that company's Search Console as unavailable and carry on with the others."
+    };
+  }
+  return {
+    action: "request_connection",
+    explanation: 'The Google account connected to Search Console cannot read any of this company\'s sites. Call the `request_connection` tool with { platform: "google-search-console", reason } so the user reconnects with a Google account that has access to the site, then carry on with the rest of the task.'
+  };
+}
+async function fetchSites(useCache = true) {
+  if (useCache) {
+    const cached = cacheGet("gsc-sites", "list");
+    if (cached) return cached.data;
+  }
+  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);
+  }
+  return data;
+}
+async function resolveSiteUrl(args) {
+  const fromArgs = args["site-url"];
+  const fromEnv = getEnv().BAKER_GSC_SITE_URL;
+  const siteUrl = fromArgs || fromEnv;
+  if (siteUrl) return siteUrl;
+  const useCache = !args["no-cache"];
+  try {
+    const listed = await fetchSites(useCache);
+    const readable = listed.filter(isReadableSite);
+    const sites = readable.length > 0 ? readable : listed;
+    const [single] = sites;
+    if (sites.length === 1 && single) {
+      process.stderr.write(`Using site "${single.siteUrl}"
+`);
+      return single.siteUrl;
+    }
+    if (sites.length === 0) {
+      handleConnectionError("gsc");
+    }
+    const list = sites.map((s) => `  ${s.siteUrl}  (${s.permissionLevel})`).join("\n");
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "MULTIPLE_SITES",
+        message: `Multiple sites found. Pass --site-url or set BAKER_GSC_SITE_URL:
+${list}`
+      }
+    });
+    process.exit(1);
+  } catch (err) {
+    handleGscError(err);
+  }
+}
+
+export {
+  handleGscError,
+  isReadableSite,
+  handleGscSiteError,
+  resolveSiteUrl
+};
+//# sourceMappingURL=chunk-L4LNS54Y.js.map

package/dist/chunk-L4LNS54Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/gsc/errors.ts","../src/commands/gsc/resolve.ts"],"sourcesContent":["import { ApiError } from \"../../client.ts\";\nimport { handleConnectionError, needsConnectionFix } from \"../../error-handler.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\n\nconst RETRYABLE_CODES = new Set([\"RATE_LIMITED\", \"UNAVAILABLE\", \"INTERNAL_ERROR\", \"NETWORK_ERROR\", \"TIMEOUT\"]);\n\n/**\n * The one error shape for every Search Console read. A dead sign-in gets the\n * in-chat reconnect whatever its wording, and every other failure says whether\n * asking again can help, so an outage is never read as a broken connection.\n */\nexport function handleGscError(err: unknown): never {\n  if (!(err instanceof ApiError)) {\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"NETWORK_ERROR\",\n        message: err instanceof Error ? err.message : \"Unexpected error\",\n        retryable: true,\n      },\n    });\n    process.exit(1);\n  }\n  if (needsConnectionFix(err.code, err.message)) {\n    handleConnectionError(\"gsc\", err.message);\n  }\n  writeJsonEnvelope({\n    ok: false,\n    error: { code: err.code, message: err.message, retryable: RETRYABLE_CODES.has(err.code) },\n  });\n  process.exit(1);\n}\n","import { ApiError, apiGet } from \"../../client.ts\";\nimport { getEnv, optionalTargetCompany } from \"../../env.ts\";\nimport { handleConnectionError } from \"../../error-handler.ts\";\nimport { cacheGet, cacheSet } from \"../ads/cache.ts\";\nimport { writeJsonEnvelope } from \"../ads/output.ts\";\nimport { handleGscError } from \"./errors.ts\";\n\ninterface GscSite {\n  siteUrl: string;\n  permissionLevel: string;\n}\n\n/** Search Console lists a site to an unverified user but answers every read of it with a 403. */\nexport function isReadableSite(site: GscSite): boolean {\n  return site.permissionLevel !== \"siteUnverifiedUser\";\n}\n\n/**\n * A query or sitemap read refused because the signed-in Google account cannot\n * read that site: name the connected sites it can read now, or ask for a\n * reconnect with an account that has access when there are none.\n */\nexport async function handleGscSiteError(err: unknown, refusedSiteUrl: string): Promise<never> {\n  if (!(err instanceof ApiError) || err.code !== \"FORBIDDEN\" || !/permission/i.test(err.message)) {\n    return handleGscError(err);\n  }\n  // Permissions change under a cached listing: ask Search Console again, past both caches.\n  let sites: GscSite[];\n  try {\n    sites = await fetchSites(false);\n  } catch {\n    return handleGscError(err);\n  }\n  const readable = sites\n    .filter((site) => isReadableSite(site) && site.siteUrl !== refusedSiteUrl)\n    .map((site) => site.siteUrl);\n  writeJsonEnvelope({\n    ok: false,\n    error: {\n      code: err.code,\n      message: err.message,\n      retryable: false,\n      fix: readable.length > 0 ? useReadableSiteFix(readable) : noReadableSiteFix(),\n    },\n  });\n  process.exit(1);\n}\n\nfunction useReadableSiteFix(readable: string[]) {\n  return {\n    action: \"use_readable_site\",\n    explanation:\n      \"The Google account connected to Search Console cannot read this site. Retrying will not help. \" +\n      `Run the same read with --site-url set to one of: ${readable.join(\", \")}.`,\n    validValues: readable,\n  };\n}\n\nfunction noReadableSiteFix() {\n  // Read with `--company` from the organization workspace: reconnecting from here\n  // would connect the workspace, not the company the read named.\n  if (optionalTargetCompany()) {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"The Google account connected to Search Console for that company cannot read any of its sites. It can only \" +\n        \"be reconnected in that company's own workspace, never with `request_connection` from here. Show that \" +\n        \"company's Search Console as unavailable and carry on with the others.\",\n    };\n  }\n  return {\n    action: \"request_connection\",\n    explanation:\n      \"The Google account connected to Search Console cannot read any of this company's sites. Call the \" +\n      '`request_connection` tool with { platform: \"google-search-console\", reason } so the user reconnects ' +\n      \"with a Google account that has access to the site, then carry on with the rest of the task.\",\n  };\n}\n\nasync function fetchSites(useCache = true): Promise<GscSite[]> {\n  if (useCache) {\n    const cached = cacheGet<GscSite[]>(\"gsc-sites\", \"list\");\n    if (cached) return cached.data;\n  }\n  const params = !useCache ? { \"skip-cache\": \"true\" } : undefined;\n  const data = await apiGet<GscSite[]>(\"/api/gsc/sites\", params);\n  if (useCache) {\n    cacheSet(\"gsc-sites\", \"list\", data, 60 * 60 * 1000);\n  }\n  return data;\n}\n\nexport async function resolveSiteUrl(args: Record<string, unknown>): Promise<string> {\n  const fromArgs = args[\"site-url\"] as string | undefined;\n  const fromEnv = getEnv().BAKER_GSC_SITE_URL;\n  const siteUrl = fromArgs || fromEnv;\n\n  if (siteUrl) return siteUrl;\n\n  const useCache = !args[\"no-cache\"];\n\n  try {\n    const listed = await fetchSites(useCache);\n    const readable = listed.filter(isReadableSite);\n    // A site the account cannot read is never picked, matching what `gsc sites` promises.\n    const sites = readable.length > 0 ? readable : listed;\n    const [single] = sites;\n    if (sites.length === 1 && single) {\n      process.stderr.write(`Using site \"${single.siteUrl}\"\\n`);\n      return single.siteUrl;\n    }\n    if (sites.length === 0) {\n      handleConnectionError(\"gsc\");\n    }\n    const list = sites.map((s) => `  ${s.siteUrl}  (${s.permissionLevel})`).join(\"\\n\");\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"MULTIPLE_SITES\",\n        message: `Multiple sites found. Pass --site-url or set BAKER_GSC_SITE_URL:\\n${list}`,\n      },\n    });\n    process.exit(1);\n  } catch (err) {\n    handleGscError(err);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-L5VVKIMB.js

@@ -0,0 +1,203 @@
+import {
+  ACTION_TEMP_ID_PREFIX
+} from "./chunk-HVJJEQDQ.js";
+import {
+  ApiError
+} from "./chunk-CIW3Q7B2.js";
+import {
+  MissingChatIdError
+} from "./chunk-VPF5A7CM.js";
+import {
+  writeJson
+} from "./chunk-HZPTQRX6.js";
+
+// src/commands/actions/tagError.ts
+var UNKNOWN_TAG_RE = /Unknown action tag\(s\): ([^.]+)\. Valid tags: ([^.]+)\./;
+function splitSlugs(list) {
+  return list.split(",").map((slug) => slug.trim()).filter((slug) => slug.length > 0);
+}
+function actionTagFix(message) {
+  const match = UNKNOWN_TAG_RE.exec(message);
+  if (!match) {
+    return null;
+  }
+  const [, unknownList, validList] = match;
+  const unknownTags = splitSlugs(unknownList ?? "");
+  const validTags = splitSlugs(validList ?? "");
+  const first = unknownTags[0];
+  if (first === void 0 || validTags.length === 0) {
+    return null;
+  }
+  return {
+    action: "retry_with_a_valid_tag",
+    explanation: `The tag(s) ${unknownTags.join(", ")} are not in this company's taxonomy. \`validTags\` below is the complete accepted set \u2014 pick from it and re-run the same command. Only mint a new tag when none of them names this work; a near-duplicate of an existing tag splits the backlog's filter instead of extending it.`,
+    unknownTags,
+    validTags,
+    mintCommand: `baker actions tags create --slug ${first} --description "<what ${first} groups>"`,
+    listCommand: "baker actions tags list"
+  };
+}
+
+// src/commands/actions/shared.ts
+function writeOk(data) {
+  writeJson({ ok: true, data: data ?? null });
+}
+function failValidation(message) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function apiFailure(err) {
+  if (err instanceof ApiError) {
+    const fix = err.fix ?? actionTagFix(err.message);
+    return { ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } };
+  }
+  if (err instanceof MissingChatIdError) {
+    const explanation = "This command stages its change on the chat this run belongs to, and this run has none. Don't retry: carry on with the rest of the job and tell the user this change couldn't be staged from here.";
+    return { ok: false, error: { code: err.code, message: err.message, fix: { action: "reject", explanation } } };
+  }
+  return {
+    ok: false,
+    error: { code: "INTERNAL_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+  };
+}
+function failApi(err) {
+  writeJson(apiFailure(err));
+  process.exit(1);
+}
+function generateTempId() {
+  return `${ACTION_TEMP_ID_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function isTempId(id) {
+  return id.startsWith(ACTION_TEMP_ID_PREFIX);
+}
+function parseTagList(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const tags = value.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+  return [...new Set(tags)];
+}
+var ACTION_PRIORITIES = ["urgent", "high", "medium", "low"];
+function parsePriority(value, { allowClear }) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    failValidation(
+      `--priority must be one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+    );
+  }
+  const trimmed = value.trim().toLowerCase();
+  if (trimmed === "") {
+    if (allowClear) {
+      return null;
+    }
+    return void 0;
+  }
+  if (allowClear && (trimmed === "none" || trimmed === "clear")) {
+    return null;
+  }
+  if (ACTION_PRIORITIES.includes(trimmed)) {
+    return trimmed;
+  }
+  failValidation(
+    `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
+  );
+}
+var FAN_OUT_NUDGE_THRESHOLD = 2;
+var FAN_OUT_THRESHOLD = 3;
+function buildCreateHints({
+  advisory,
+  name,
+  description,
+  tempId,
+  tags,
+  prioritySet,
+  draftCreateCount
+}) {
+  const hints = [];
+  const expanded = shellExpandedIn(`${name}
+${description}`);
+  if (expanded) {
+    hints.push(
+      `The text says \u201C${expanded}\u201D: the shell replaced a $ amount (like $0) inside double quotes before Baker saw it. Fix it now: baker actions update ${tempId} --description '<the text, with the amounts as you read them>' (and --name '\u2026' if the name has it) \u2014 single quotes keep $ as written.`
+    );
+  }
+  if (advisory) {
+    hints.push(
+      `${advisory.hint} If nothing actually blocks it: baker actions draft remove ${tempId}, then do the work.`
+    );
+  }
+  if (draftCreateCount >= FAN_OUT_THRESHOLD) {
+    hints.push(
+      `${draftCreateCount} Tasks are staged in this chat. Re-read them with \`baker actions draft\`: can any be done now with a surface you already have, and do any two touch the same system (same container, same campaign, same page)? Those belong in ONE Task \u2014 fold them together with \`baker actions update\` and drop the extras with \`baker actions draft remove <tempId>\`.`
+    );
+  } else if (draftCreateCount === FAN_OUT_NUDGE_THRESHOLD) {
+    hints.push(
+      `Second Task staged in this chat. If these two land on the same system (same container, same campaign, same page) they are ONE Task \u2014 fold them with \`baker actions update\` and drop the extra with \`baker actions draft remove ${tempId}\`.`
+    );
+  }
+  hints.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);
+  if (!description) {
+    hints.push("Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)");
+  }
+  if (!tags || tags.length === 0) {
+    hints.push(
+      "MISSING --tags. This action is invisible to the backlog's tag filter. Re-run with --tags <slug,...> (`baker actions tags list` for the taxonomy, `baker actions tags create --slug <slug>` to mint) \u2014 or `baker actions update <tempId> --tags <slug,...>`."
+    );
+  }
+  if (!prioritySet) {
+    hints.push(
+      `MISSING --priority. Without it this action ranks as 'normal' (medium) in the do-first ordering, so urgent/high client work won't surface first. Re-run with --priority ${ACTION_PRIORITIES.join("|")} \u2014 or \`baker actions update <tempId> --priority <level>\`.`
+    );
+  }
+  return hints;
+}
+var SHELL_PATH = /(?:^|[\s(])((?:\/usr)?\/bin\/(?:ba|z|da|k)?sh|-(?:ba|z|da|k)sh)\b/;
+var MONEY_WORD = "spend|spent|spending|budget|revenue|sales|cost|costs|cpa|cpc|cpm|cpl|roas|profit|paid|earned";
+var BARE_SHELL = new RegExp(
+  `(?:\\b(?:${MONEY_WORD}|at|to|from|was|were|is)\\s+(bash|zsh)\\b|(?:^|[\\s(])(bash|zsh)(?=\\.\\d|\\s+(?:${MONEY_WORD})\\b))`,
+  "gi"
+);
+function shellExpandedIn(text) {
+  const path = SHELL_PATH.exec(text)?.[1];
+  if (path) return path;
+  for (const match of text.matchAll(BARE_SHELL)) {
+    const name = match[1] ?? match[2];
+    if (name && name === name.toLowerCase()) return name;
+  }
+  return null;
+}
+var ACTIONS_LIST_DEFAULT_LIMIT = 500;
+function buildListHints({ returned, limit }) {
+  if (returned < limit) {
+    return [];
+  }
+  return [
+    `This list is capped at ${limit} Tasks and came back full, so older Tasks exist that are NOT shown. Do not treat it as the whole backlog \u2014 re-run with --limit ${limit * 2} (or narrow with --status / --search).`
+  ];
+}
+function buildGetHints(detail) {
+  if (detail?.action.status !== "pending" || detail.activeChat !== null) {
+    return [];
+  }
+  return [
+    `If you are working on this Task in this chat, claim it first so the Tasks page shows it in progress: baker actions claim ${detail.action._id}`
+  ];
+}
+
+export {
+  writeOk,
+  failValidation,
+  failApi,
+  generateTempId,
+  isTempId,
+  parseTagList,
+  ACTION_PRIORITIES,
+  parsePriority,
+  buildCreateHints,
+  ACTIONS_LIST_DEFAULT_LIMIT,
+  buildListHints,
+  buildGetHints
+};
+//# sourceMappingURL=chunk-L5VVKIMB.js.map