@koda-sl/baker-cli 0.449.0 → 0.450.0-dev.b454c3dd2

package/dist/chunk-35XWJEWH.js

@@ -1,274 +0,0 @@
-import {
-  chatgptDraftOpInputSchema,
-  chatgptFailure
-} from "./chunk-KLBTXETO.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-VFIOJD5M.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import {
-  requireChatId
-} from "./chunk-NAWWC5I3.js";
-import {
-  registerSchema
-} from "./chunk-NU7JSWVA.js";
-
-// src/commands/ads/chatgpt/write-shared.ts
-import { defineCommand } from "citty";
-function fail(envelope) {
-  writeJsonEnvelope({ ...envelope });
-  process.exit(1);
-}
-function failWriteValidation(message) {
-  fail({
-    ok: false,
-    error: {
-      code: "VALIDATION_ERROR",
-      message,
-      fix: { action: "add_required_field", explanation: `${message}. Nothing was staged.` },
-      retryable: false
-    }
-  });
-}
-function writeFailure(err, reference) {
-  if (!(err instanceof ApiError) && err instanceof Error && err.message.includes("BAKER_CHAT_ID")) {
-    return {
-      ok: false,
-      error: {
-        code: "NO_CHAT",
-        message: err.message,
-        fix: {
-          action: "reject",
-          explanation: "ChatGPT Ads changes are staged on a chat and apply when it is published; run this from the chat."
-        },
-        retryable: false
-      }
-    };
-  }
-  return chatgptFailure(err, reference);
-}
-function decimalPlaces(value) {
-  const [mantissa, exponent] = String(value).trim().split(/e/i);
-  const written = (mantissa?.split(".")[1] ?? "").length;
-  return Math.max(0, written - (exponent ? Number(exponent) : 0));
-}
-function parseChatgptMoney(value) {
-  if (value === void 0 || value === "") {
-    return { ok: true, micros: void 0 };
-  }
-  const amount = Number(value);
-  if (!Number.isFinite(amount) || amount <= 0) {
-    return { ok: false, reason: "must be a positive amount, for example 12.50" };
-  }
-  if (decimalPlaces(value) > 6) {
-    return { ok: false, reason: "is finer than ChatGPT Ads can express" };
-  }
-  return { ok: true, micros: Math.round(amount * 1e6) };
-}
-function microsFromArg(value, flag) {
-  const parsed = parseChatgptMoney(value);
-  if (!parsed.ok) {
-    failWriteValidation(`${flag} ${parsed.reason}`);
-  }
-  return parsed.micros;
-}
-function csvArg(value) {
-  if (typeof value !== "string" || value.trim().length === 0) {
-    return void 0;
-  }
-  const parts = value.split(",").map((part) => part.trim()).filter(Boolean);
-  return parts.length > 0 ? parts : void 0;
-}
-function schemaArgs(args) {
-  return Object.fromEntries(
-    Object.entries(args).map(([name, arg]) => [
-      name,
-      {
-        type: arg.type === "positional" ? "string" : arg.type,
-        description: arg.description,
-        required: arg.required === true
-      }
-    ])
-  );
-}
-function lowerArg(value) {
-  return typeof value === "string" && value.trim() !== "" ? value.trim().toLowerCase() : void 0;
-}
-function lowerCsvArg(value) {
-  return csvArg(value)?.map((part) => part.toLowerCase());
-}
-function compact(payload) {
-  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0 && value !== ""));
-}
-function requireTarget(args, name) {
-  const value = args[name];
-  if (typeof value !== "string" || value.trim().length === 0) {
-    failWriteValidation(`${name} is required`);
-  }
-  return value.trim();
-}
-function requireTargets(args, name) {
-  const ids = csvArg(args[name]);
-  if (!ids) {
-    failWriteValidation(`${name} is required \u2014 pass one or more ids, comma-separated`);
-  }
-  return ids;
-}
-function preflight(raw) {
-  const parsed = chatgptDraftOpInputSchema.safeParse(raw);
-  if (parsed.success) {
-    return parsed.data;
-  }
-  const fields = parsed.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message }));
-  const message = fields.map((field) => field.path ? `${field.path}: ${field.message}` : field.message).join("; ");
-  return fail({
-    ok: false,
-    error: {
-      code: "VALIDATION_ERROR",
-      message,
-      fix: {
-        action: "retry_with_modified_query",
-        explanation: "Fix the named fields and stage again. Nothing was staged \u2014 the draft is as it was before this call."
-      },
-      retryable: false
-    }
-  });
-}
-async function postStage(chatId, op) {
-  return await apiPost("/api/ads/chatgpt/draft/stage", { chatId, op });
-}
-async function stageChatgptOp(raw, reference, hintsFor) {
-  const op = preflight(raw);
-  try {
-    const staged = await postStage(requireChatId(), op);
-    const hints = hintsFor?.(staged) ?? [];
-    writeJsonEnvelope({ ok: true, data: staged, ...hints.length > 0 ? { hints } : {} });
-  } catch (err) {
-    fail(writeFailure(err, reference));
-  }
-}
-async function stageChatgptOps(raws, reference) {
-  if (raws.length === 1 && raws[0]) {
-    await stageChatgptOp(raws[0], reference);
-    return;
-  }
-  const ops = raws.map(preflight);
-  const staged = [];
-  try {
-    const chatId = requireChatId();
-    for (const op of ops) {
-      staged.push(await postStage(chatId, op));
-    }
-    writeJsonEnvelope({ ok: true, data: staged });
-  } catch (err) {
-    const failure = writeFailure(err, reference);
-    if (staged.length > 0) {
-      failure.error.message = `${failure.error.message} (already staged: ${staged.map((s) => s.summary).join("; ")})`;
-    }
-    fail(failure);
-  }
-}
-function clearableCsvArg(value) {
-  return typeof value === "string" && value.trim().toLowerCase() === "none" ? [] : csvArg(value);
-}
-function clearableArg(value) {
-  if (typeof value !== "string" || value.trim() === "") {
-    return void 0;
-  }
-  return value.trim().toLowerCase() === "none" ? null : value.trim();
-}
-function cropArg(value, flag) {
-  const parts = csvArg(value);
-  if (!parts) {
-    return void 0;
-  }
-  const numbers = parts.map(Number);
-  const [x, y, width, height] = numbers;
-  if (numbers.length !== 4 || numbers.some(Number.isNaN) || x === void 0 || y === void 0 || width === void 0 || height === void 0) {
-    failWriteValidation(`${flag} takes four shares of the image, x,y,width,height \u2014 e.g. 0.1,0,0.8,0.8`);
-  }
-  return { x, y, width, height };
-}
-var STATUS_OF = {
-  pause: "paused",
-  resume: "active",
-  archive: "archived"
-};
-function statusOps(entity, ids, status) {
-  return ids.map((id) => ({ kind: `${entity}.update`, target: id, payload: { status } }));
-}
-var STATUS_NOUN = {
-  campaign: { command: "campaigns", plural: "campaigns", example: "cmpn_123,cmpn_456" },
-  adGroup: { command: "ad-groups", plural: "ad groups", example: "adgrp_123,adgrp_456" },
-  ad: { command: "ads", plural: "cards", example: "ad_123,ad_456" }
-};
-var STATUS_DOING = { pause: "pausing", resume: "resuming", archive: "archiving" };
-function statusCommand(entity, verb, reference) {
-  const noun = STATUS_NOUN[entity];
-  const args = {
-    ids: { type: "positional", description: `${noun.plural} ids, comma-separated`, required: true }
-  };
-  const forGood = verb === "archive" ? ` Archiving is for good: ChatGPT Ads cannot bring archived ${noun.plural} back, and their results stay in reports. Pause instead unless the user asked to archive.` : "";
-  registerSchema({
-    command: `ads.chatgpt.${noun.command}.${verb}`,
-    description: `Stage ${STATUS_DOING[verb]} one or more ChatGPT Ads ${noun.plural}. Pass every id in one call.${forGood}`,
-    args: schemaArgs(args)
-  });
-  return defineCommand({
-    meta: {
-      name: verb,
-      description: `Stage ${STATUS_DOING[verb]} ${noun.plural}.${forGood}
-
-Example:
-  baker ads chatgpt ${noun.command} ${verb} ${noun.example}`
-    },
-    args,
-    run: async ({ args: parsed }) => {
-      await stageChatgptOps(statusOps(entity, requireTargets(parsed, "ids"), STATUS_OF[verb]), reference);
-    }
-  });
-}
-function productFiltersArg(value) {
-  if (typeof value !== "string" || value.trim() === "") {
-    return void 0;
-  }
-  if (value.trim().toLowerCase() === "none") {
-    return [];
-  }
-  return value.split(";").map((condition) => condition.trim()).filter(Boolean).map((condition) => {
-    const match = /^(\S+)\s+(\S+)\s+(.+)$/.exec(condition);
-    if (!match?.[1] || !match[2] || !match[3]) {
-      failWriteValidation(
-        `"${condition}" is not a product filter \u2014 write field operator values, e.g. price lte 5000`
-      );
-    }
-    return {
-      field: match[1],
-      operator: match[2].toLowerCase(),
-      values: match[3].split("|").map((part) => part.trim()).filter(Boolean)
-    };
-  });
-}
-
-export {
-  failWriteValidation,
-  microsFromArg,
-  csvArg,
-  schemaArgs,
-  lowerArg,
-  lowerCsvArg,
-  compact,
-  requireTarget,
-  requireTargets,
-  stageChatgptOp,
-  stageChatgptOps,
-  clearableCsvArg,
-  clearableArg,
-  cropArg,
-  statusCommand,
-  productFiltersArg
-};
-//# sourceMappingURL=chunk-35XWJEWH.js.map

package/dist/chunk-3G3ZDLMI.js

@@ -1,197 +0,0 @@
-import {
-  mediaTagsCreateRequestSchema,
-  mediaTagsDeleteRequestSchema,
-  mediaTagsUpdateRequestSchema
-} from "./chunk-XF4JUKVF.js";
-import {
-  ApiError,
-  apiGet,
-  apiPost
-} from "./chunk-XBOK23HI.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-NU7JSWVA.js";
-
-// src/lib/tags-command.ts
-import { defineCommand } from "citty";
-var OUTPUT_ARG = {
-  output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
-};
-var SHARED_POOL_HINT = "Custom tags are one pool shared by images, videos and testimonials \u2014 this change shows up in all three. Already applied: publishing or discarding this chat does not undo it.";
-function fail(err) {
-  const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
-  const message = err instanceof ApiError ? err.message : "Unexpected error";
-  writeJson({ ok: false, error: { code, message } });
-  process.exit(1);
-}
-function failInvalid(issue) {
-  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: issue?.message ?? "Invalid request" } });
-  process.exit(1);
-}
-function makeTagsCommand(command, label, endpoint) {
-  registerSchema({
-    command: `${command}.tags.list`,
-    description: `List the available ${label} tag taxonomy (built-in defaults + this company's custom tags).`,
-    args: OUTPUT_ARG
-  });
-  const listCommand = defineCommand({
-    meta: {
-      name: "list",
-      description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
-    },
-    args: OUTPUT_ARG,
-    run: async ({ args }) => {
-      try {
-        const { markdown } = await apiGet(endpoint);
-        if (args.output === "json") {
-          writeJson({ ok: true, data: { markdown } });
-          return;
-        }
-        process.stdout.write(`${markdown.trimEnd()}
-`);
-      } catch (err) {
-        const code = err instanceof ApiError ? err.code : "INTERNAL_ERROR";
-        const message = err instanceof ApiError ? err.message : "Unexpected error";
-        if (args.output === "json") {
-          writeJson({ ok: false, error: { code, message } });
-        } else {
-          process.stderr.write(`Error: ${message}
-`);
-        }
-        process.exit(1);
-      }
-    }
-  });
-  const createArgs = {
-    name: { type: "positional", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
-    description: {
-      type: "string",
-      description: "What the tag means, so it gets applied consistently",
-      required: false
-    }
-  };
-  registerSchema({
-    command: `${command}.tags.create`,
-    description: "Create a custom media tag in the company's shared pool (images, videos and testimonials). Applies immediately. Use when no built-in or custom tag fits.",
-    args: {
-      name: { type: "string", description: "Tag name (stored lowercased, spaces \u2192 hyphens)", required: true },
-      description: createArgs.description
-    }
-  });
-  const createCommand = defineCommand({
-    meta: {
-      name: "create",
-      description: `Create a custom tag (shared by images, videos and testimonials). Applies immediately.
-
-Example: baker ${command} tags create "summer sale" --description "Assets for the summer sale campaign"`
-    },
-    args: createArgs,
-    run: async ({ args }) => {
-      const parsed = mediaTagsCreateRequestSchema.safeParse({
-        name: String(args.name ?? ""),
-        ...args.description ? { description: String(args.description) } : {}
-      });
-      if (!parsed.success) failInvalid(parsed.error.issues[0]);
-      try {
-        const data = await apiPost("/api/media-tags/create", parsed.data);
-        writeJson({
-          ok: true,
-          data,
-          hints: [
-            SHARED_POOL_HINT,
-            `Use it as \`--tags ${data.name}\`.`,
-            ...data.description ? [] : ["MISSING --description: add one with `tags update` so the tag is applied consistently."]
-          ]
-        });
-      } catch (err) {
-        fail(err);
-      }
-    }
-  });
-  registerSchema({
-    command: `${command}.tags.update`,
-    description: "Change what a custom tag means (its description). Built-in tags cannot be changed. Applies immediately.",
-    args: {
-      slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true },
-      description: { type: "string", description: "New description", required: true }
-    }
-  });
-  const updateCommand = defineCommand({
-    meta: {
-      name: "update",
-      description: `Change a custom tag's description. Built-in tags cannot be changed. Applies immediately.
-
-Example: baker ${command} tags update summer-sale --description "Assets for the 2026 summer sale"`
-    },
-    args: {
-      slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true },
-      description: { type: "string", description: "New description", required: true }
-    },
-    run: async ({ args }) => {
-      const parsed = mediaTagsUpdateRequestSchema.safeParse({
-        slug: String(args.slug ?? ""),
-        description: String(args.description ?? "")
-      });
-      if (!parsed.success) failInvalid(parsed.error.issues[0]);
-      try {
-        const data = await apiPost("/api/media-tags/update", parsed.data);
-        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
-      } catch (err) {
-        fail(err);
-      }
-    }
-  });
-  registerSchema({
-    command: `${command}.tags.delete`,
-    description: "Delete a custom tag from the company's shared pool. Built-in tags cannot be deleted. Applies immediately. Confirm with the user first.",
-    args: { slug: { type: "string", description: "Custom tag name, as `tags` lists it", required: true } }
-  });
-  const deleteCommand = defineCommand({
-    meta: {
-      name: "delete",
-      description: `Delete a custom tag (shared by images, videos and testimonials). Built-in tags cannot be deleted. Applies immediately \u2014 confirm with the user first.
-
-Example: baker ${command} tags delete summer-sale`
-    },
-    args: { slug: { type: "positional", description: "Custom tag name, as `tags` lists it", required: true } },
-    run: async ({ args }) => {
-      const parsed = mediaTagsDeleteRequestSchema.safeParse({ slug: String(args.slug ?? "") });
-      if (!parsed.success) failInvalid(parsed.error.issues[0]);
-      try {
-        const data = await apiPost("/api/media-tags/delete", parsed.data);
-        writeJson({ ok: true, data, hints: [SHARED_POOL_HINT] });
-      } catch (err) {
-        fail(err);
-      }
-    }
-  });
-  return defineCommand({
-    meta: {
-      name: "tags",
-      description: `The ${label} tag taxonomy: built-in defaults plus the company's custom tags (one pool shared by images, videos and testimonials). Subcommands: list (default), create, update, delete.
-
-Examples:
-  baker ${command} tags                                   # list available tags
-  baker ${command} tags create "summer sale" --description "\u2026"
-  baker ${command} tags update summer-sale --description "\u2026"
-  baker ${command} tags delete summer-sale`
-    },
-    // Declared on the parent too: `default: "list"` dispatches the bare `tags --output json`
-    // form, and citty reads an undeclared flag's value as a subcommand name.
-    args: OUTPUT_ARG,
-    subCommands: {
-      list: listCommand,
-      create: createCommand,
-      update: updateCommand,
-      delete: deleteCommand
-    },
-    // `default`, never `run`: citty falls through to the parent's `run` after a subcommand.
-    default: "list"
-  });
-}
-
-export {
-  makeTagsCommand
-};
-//# sourceMappingURL=chunk-3G3ZDLMI.js.map

package/dist/chunk-3HJLHTWP.js

@@ -1,163 +0,0 @@
-import {
-  ACTION_TEMP_ID_PREFIX
-} from "./chunk-XF4JUKVF.js";
-import {
-  ApiError
-} from "./chunk-XBOK23HI.js";
-import {
-  writeJson
-} from "./chunk-NU7JSWVA.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 failApi(err) {
-  if (err instanceof ApiError) {
-    const fix = actionTagFix(err.message);
-    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
-    process.exit(1);
-  }
-  if (err instanceof Error) {
-    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  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,
-  description,
-  tempId,
-  tags,
-  prioritySet,
-  draftCreateCount
-}) {
-  const hints = [];
-  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 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).`
-  ];
-}
-
-export {
-  writeOk,
-  failValidation,
-  failApi,
-  generateTempId,
-  isTempId,
-  parseTagList,
-  ACTION_PRIORITIES,
-  parsePriority,
-  buildCreateHints,
-  ACTIONS_LIST_DEFAULT_LIMIT,
-  buildListHints
-};
-//# sourceMappingURL=chunk-3HJLHTWP.js.map

package/dist/chunk-3HJLHTWP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/actions/tagError.ts","../src/commands/actions/shared.ts"],"sourcesContent":["/**\n * Structured remediation for the one `actions` failure an agent cannot fix from\n * the message alone: an unknown `--tags` slug.\n *\n * The backend already inlines the valid taxonomy in the rejection text\n * (`unknownActionTagMessage`, packages/backend/convex/actionItems/tags/utils.ts),\n * but only `{ code, message }` crosses the HTTP boundary into `ApiError`. Parsing\n * the two lists back out here is what lets `error.fix` carry them as data, so the\n * agent retries in the same call instead of running `tags list` and trying again\n * — the \"list-then-retry dance\" this file exists to end.\n *\n * Fails closed: anything that doesn't match exactly returns `null` and the caller\n * emits the plain message it would have emitted anyway.\n */\n\nconst UNKNOWN_TAG_RE = /Unknown action tag\\(s\\): ([^.]+)\\. Valid tags: ([^.]+)\\./;\n\n// A type alias, not an interface: the envelope's `fix` slot is\n// `{ action, explanation } & Record<string, unknown>`, and only an alias is\n// structurally assignable to that index signature.\nexport type ActionTagFix = {\n  action: \"retry_with_a_valid_tag\";\n  explanation: string;\n  unknownTags: string[];\n  validTags: string[];\n  mintCommand: string;\n  listCommand: string;\n};\n\nfunction splitSlugs(list: string): string[] {\n  return list\n    .split(\",\")\n    .map((slug) => slug.trim())\n    .filter((slug) => slug.length > 0);\n}\n\nexport function actionTagFix(message: string): ActionTagFix | null {\n  const match = UNKNOWN_TAG_RE.exec(message);\n  if (!match) {\n    return null;\n  }\n  const [, unknownList, validList] = match;\n  const unknownTags = splitSlugs(unknownList ?? \"\");\n  const validTags = splitSlugs(validList ?? \"\");\n  const first = unknownTags[0];\n  if (first === undefined || validTags.length === 0) {\n    return null;\n  }\n  return {\n    action: \"retry_with_a_valid_tag\",\n    explanation:\n      `The tag(s) ${unknownTags.join(\", \")} are not in this company's taxonomy. ` +\n      `\\`validTags\\` below is the complete accepted set — pick from it and re-run the same command. ` +\n      `Only mint a new tag when none of them names this work; a near-duplicate of an existing tag ` +\n      `splits the backlog's filter instead of extending it.`,\n    unknownTags,\n    validTags,\n    mintCommand: `baker actions tags create --slug ${first} --description \"<what ${first} groups>\"`,\n    listCommand: \"baker actions tags list\",\n  };\n}\n","import { ACTION_TEMP_ID_PREFIX } from \"@baker/api\";\nimport { ApiError } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport type { AdvisoryHint } from \"./advisory.ts\";\nimport { actionTagFix } from \"./tagError.ts\";\n\nexport function writeOk<T = null>(data?: T): void {\n  writeJson({ ok: true, data: (data ?? null) as T });\n}\n\nexport function failValidation(message: string): never {\n  writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\n// Every actions command routes its API failures through here, so attaching the\n// tag `fix` at this one point covers `create`, `update`, and any later write\n// path that hits the same strict tag gate. Non-tag errors are untouched.\nexport function failApi(err: unknown): never {\n  if (err instanceof ApiError) {\n    const fix = actionTagFix(err.message);\n    writeJson({ ok: false, error: { code: err.code, message: err.message, ...(fix ? { fix } : {}) } });\n    process.exit(1);\n  }\n  if (err instanceof Error) {\n    writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: err.message } });\n    process.exit(1);\n  }\n  writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\nexport function generateTempId(): string {\n  return `${ACTION_TEMP_ID_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function isTempId(id: string): boolean {\n  return id.startsWith(ACTION_TEMP_ID_PREFIX);\n}\n\n// Parse a `--tags a,b,c` CSV flag into a deduped slug list. Returns undefined\n// when the flag was omitted so callers can distinguish \"not provided\" from\n// \"explicitly cleared\" (empty list).\nexport function parseTagList(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  const tags = value\n    .split(\",\")\n    .map((t) => t.trim())\n    .filter((t) => t.length > 0);\n  return [...new Set(tags)];\n}\n\n// User priority for an action. Drives the dependency-aware \"Do first\" ordering\n// in `baker actions list`. Unset == \"normal\" (ranks as medium).\nexport const ACTION_PRIORITIES = [\"urgent\", \"high\", \"medium\", \"low\"] as const;\ntype ActionPriority = (typeof ACTION_PRIORITIES)[number];\n\n// Parse a `--priority` flag. Returns:\n//   - undefined → flag omitted (leave unchanged on update; unset on create)\n//   - null      → explicit clear (only meaningful on update; \"\" or \"none\")\n//   - one of ACTION_PRIORITIES on a valid value\n// Fails validation on any other string so the agent gets an immediate error.\nexport function parsePriority(\n  value: unknown,\n  { allowClear }: { allowClear: boolean },\n): ActionPriority | null | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  if (typeof value !== \"string\") {\n    failValidation(\n      `--priority must be one of: ${ACTION_PRIORITIES.join(\", \")}${allowClear ? \", or 'none' to clear\" : \"\"}.`,\n    );\n  }\n  const trimmed = value.trim().toLowerCase();\n  if (trimmed === \"\") {\n    if (allowClear) {\n      return null;\n    }\n    return undefined;\n  }\n  if (allowClear && (trimmed === \"none\" || trimmed === \"clear\")) {\n    return null;\n  }\n  if ((ACTION_PRIORITIES as readonly string[]).includes(trimmed)) {\n    return trimmed as ActionPriority;\n  }\n  failValidation(\n    `Unknown --priority \"${value}\". Expected one of: ${ACTION_PRIORITIES.join(\", \")}${allowClear ? \", or 'none' to clear\" : \"\"}.`,\n  );\n}\n\n// Two tiers, because the two counts want different amounts of words.\n//\n// The mean chat that files anything files ~2, and two Tasks is already above\n// the bar (\"a Task is the exception\"), so a 2→1 merge is the cheapest win\n// available — but firing the full paragraph on the modal chat is how you train\n// the model to skim `hints[]` and miss the do-it-now redirect above it. So 2\n// gets one sentence.\n//\n// Three is where \"capturing follow-ups\" stops looking like a backlog and\n// starts looking like a to-do list handed back to the user. That gets the\n// paragraph, from there on, every time — a legitimate 3-Task chat (an approved\n// plan) still benefits from being asked whether any two merge.\nexport const FAN_OUT_NUDGE_THRESHOLD = 2;\nexport const FAN_OUT_THRESHOLD = 3;\n\n// Every hint `create` returns, in reading order. The two that argue against\n// the action existing come first — by the time the agent reaches \"add tags\" it\n// has already accepted the action as a given.\nexport function buildCreateHints({\n  advisory,\n  description,\n  tempId,\n  tags,\n  prioritySet,\n  draftCreateCount,\n}: {\n  /** What the Task reads as (`advisory.ts`), decided before: recurring work, or work a surface does now. */\n  advisory: AdvisoryHint | null;\n  description: string;\n  tempId: string;\n  tags: string[] | undefined;\n  prioritySet: boolean;\n  draftCreateCount: number;\n}): string[] {\n  const hints: string[] = [];\n  if (advisory) {\n    hints.push(\n      `${advisory.hint} If nothing actually blocks it: baker actions draft remove ${tempId}, then do the work.`,\n    );\n  }\n  // The advisory reading is a judgment; this count is a fact. It keeps firing on\n  // every further create — a chat that fanned out into a to-do list is the\n  // failure the whole hint set exists to catch.\n  if (draftCreateCount >= FAN_OUT_THRESHOLD) {\n    hints.push(\n      `${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 — fold them together with \\`baker actions update\\` and drop the extras with \\`baker actions draft remove <tempId>\\`.`,\n    );\n  } else if (draftCreateCount === FAN_OUT_NUDGE_THRESHOLD) {\n    hints.push(\n      `Second Task staged in this chat. If these two land on the same system (same container, same campaign, same page) they are ONE Task — fold them with \\`baker actions update\\` and drop the extra with \\`baker actions draft remove ${tempId}\\`.`,\n    );\n  }\n  hints.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);\n  if (!description) {\n    hints.push(\"Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)\");\n  }\n  if (!tags || tags.length === 0) {\n    hints.push(\n      \"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) — or `baker actions update <tempId> --tags <slug,...>`.\",\n    );\n  }\n  if (!prioritySet) {\n    hints.push(\n      `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(\"|\")} — or \\`baker actions update <tempId> --priority <level>\\`.`,\n    );\n  }\n  return hints;\n}\n\n/**\n * How far back a flat `baker actions list` reads when the caller does not say.\n *\n * Sent explicitly rather than left to the server default so this side knows the\n * window it asked for, and can therefore tell when a read came back exactly full\n * — the only evidence available that older Tasks exist. Without that the agent\n * reads a truncated backlog as a complete one and reports finished work that was\n * never seen.\n */\nexport const ACTIONS_LIST_DEFAULT_LIMIT = 500;\n\nexport function buildListHints({ returned, limit }: { returned: number; limit: number }): string[] {\n  if (returned < limit) {\n    return [];\n  }\n  return [\n    `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 — re-run with --limit ${limit * 2} (or narrow with --status / --search).`,\n  ];\n}\n"],"mappings":"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","names":[]}