@koda-sl/baker-cli 0.386.0-dev.4e118c09a → 0.386.0-dev.d6e55699d

package/dist/chunk-XE3WS3QE.js

@@ -0,0 +1,183 @@
+import {
+  ACTION_TEMP_ID_PREFIX
+} from "./chunk-KRIK2JR4.js";
+import {
+  ApiError
+} from "./chunk-HREWXNTO.js";
+import {
+  writeJson
+} from "./chunk-WOTDHRNF.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,
+  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;
+}
+function shellExpandedIn(text) {
+  return /(?:^|[\s(])((?:\/usr)?\/bin\/(?:ba|z|da|k)?sh|-?(?:ba|z|da|k)sh)\b/.exec(text)?.[1] ?? 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-XE3WS3QE.js.map

package/dist/chunk-XE3WS3QE.js.map

@@ -0,0 +1 @@
+{"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  name,\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  name: string;\n  description: string;\n  tempId: string;\n  tags: string[] | undefined;\n  prioritySet: boolean;\n  draftCreateCount: number;\n}): string[] {\n  const hints: string[] = [];\n  const expanded = shellExpandedIn(`${name}\\n${description}`);\n  if (expanded) {\n    hints.push(\n      `The text says “${expanded}”: 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 '…' if the name has it) — single quotes keep $ as written.`,\n    );\n  }\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 * A shell's name where a `$0` stood — its path, or plain `bash` under\n * `bash -c`, `-bash` in a login shell: double-quoted text loses its money\n * amounts to the shell before the CLI ever sees them.\n */\nfunction shellExpandedIn(text: string): string | null {\n  return /(?:^|[\\s(])((?:\\/usr)?\\/bin\\/(?:ba|z|da|k)?sh|-?(?:ba|z|da|k)sh)\\b/.exec(text)?.[1] ?? null;\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\n/**\n * A pending Task nobody is working on is one the agent was most likely asked to\n * solve: without a claim the dashboard shows no work in progress on it.\n */\nexport function buildGetHints(\n  detail: { action: { _id: string; status: string }; activeChat: unknown } | null,\n): string[] {\n  if (detail?.action.status !== \"pending\" || detail.activeChat !== null) {\n    return [];\n  }\n  return [\n    `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}`,\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-XGWKTYXQ.js

@@ -0,0 +1,67 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-BVM5IRZW.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-HREWXNTO.js";
+
+// src/commands/ads/x/run-list.ts
+function buildCleanParams(opts) {
+  const out = {};
+  for (const [k, v] of Object.entries(opts.params)) {
+    if (v !== void 0 && v !== "") {
+      out[k] = v;
+    }
+  }
+  if (!opts.useCache) {
+    out["skip-cache"] = "true";
+  }
+  return out;
+}
+function emitFromCache(opts) {
+  if (!opts.useCache || opts.cacheTtlMs === void 0) return false;
+  const cached = cacheGet(opts.cacheCategory, opts.cacheKey);
+  if (!cached) return false;
+  writeAdsJson({ ok: true, data: cached.data, cached: true });
+  return true;
+}
+function emitData(opts, data) {
+  if (opts.format !== "json") {
+    writeAdsOutput(data, opts.format);
+    return;
+  }
+  writeAdsJson({ ok: true, data });
+}
+function emitError(opts, err) {
+  if (err instanceof ApiError) {
+    writeAdsJson(parseXApiError(err.message, opts.accountId ?? "\u2014"));
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+async function runListCommand(opts) {
+  if (emitFromCache(opts)) return;
+  const params = buildCleanParams(opts);
+  try {
+    const data = await apiGet(opts.path, params);
+    if (opts.useCache && opts.cacheTtlMs !== void 0) {
+      cacheSet(opts.cacheCategory, opts.cacheKey, data, opts.cacheTtlMs);
+    }
+    emitData(opts, data);
+  } catch (err) {
+    emitError(opts, err);
+  }
+}
+
+export {
+  runListCommand
+};
+//# sourceMappingURL=chunk-XGWKTYXQ.js.map

package/dist/chunk-XGWKTYXQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/run-list.ts"],"sourcesContent":["import { ApiError, apiGet } from \"../../../client.ts\";\nimport { cacheGet, cacheSet } from \"../cache.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport { parseXApiError } from \"./error-parser.ts\";\n\ninterface ListParams {\n  path: string;\n  cacheCategory: string;\n  cacheKey: string;\n  cacheTtlMs?: number;\n  params: Record<string, string | undefined>;\n  format: string;\n  accountId?: string;\n  useCache: boolean;\n}\n\nfunction buildCleanParams(opts: ListParams): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const [k, v] of Object.entries(opts.params)) {\n    if (v !== undefined && v !== \"\") {\n      out[k] = v;\n    }\n  }\n  if (!opts.useCache) {\n    out[\"skip-cache\"] = \"true\";\n  }\n  return out;\n}\n\nfunction emitFromCache(opts: ListParams): boolean {\n  if (!opts.useCache || opts.cacheTtlMs === undefined) return false;\n  const cached = cacheGet<unknown[]>(opts.cacheCategory, opts.cacheKey);\n  if (!cached) return false;\n  writeAdsJson({ ok: true, data: cached.data, cached: true });\n  return true;\n}\n\nfunction emitData(opts: ListParams, data: unknown[]): void {\n  if (opts.format !== \"json\") {\n    writeAdsOutput(data as Array<Record<string, unknown>>, opts.format);\n    return;\n  }\n  writeAdsJson({ ok: true, data });\n}\n\nfunction emitError(opts: ListParams, err: unknown): never {\n  if (err instanceof ApiError) {\n    writeAdsJson(parseXApiError(err.message, opts.accountId ?? \"—\"));\n    process.exit(1);\n  }\n  writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\n/**\n * Shared GET-list flow: cache check → request → cache set → format-aware output.\n * Centralizing this keeps each CLI command file under Biome's complexity budget.\n */\nexport async function runListCommand(opts: ListParams): Promise<void> {\n  if (emitFromCache(opts)) return;\n  const params = buildCleanParams(opts);\n  try {\n    const data = await apiGet<unknown[]>(opts.path, params);\n    if (opts.useCache && opts.cacheTtlMs !== undefined) {\n      cacheSet(opts.cacheCategory, opts.cacheKey, data, opts.cacheTtlMs);\n    }\n    emitData(opts, data);\n  } catch (err) {\n    emitError(opts, err);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAS,iBAAiB,MAA0C;AAClE,QAAM,MAA8B,CAAC;AACrC,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,KAAK,MAAM,GAAG;AAChD,QAAI,MAAM,UAAa,MAAM,IAAI;AAC/B,UAAI,CAAC,IAAI;AAAA,IACX;AAAA,EACF;AACA,MAAI,CAAC,KAAK,UAAU;AAClB,QAAI,YAAY,IAAI;AAAA,EACtB;AACA,SAAO;AACT;AAEA,SAAS,cAAc,MAA2B;AAChD,MAAI,CAAC,KAAK,YAAY,KAAK,eAAe,OAAW,QAAO;AAC5D,QAAM,SAAS,SAAoB,KAAK,eAAe,KAAK,QAAQ;AACpE,MAAI,CAAC,OAAQ,QAAO;AACpB,eAAa,EAAE,IAAI,MAAM,MAAM,OAAO,MAAM,QAAQ,KAAK,CAAC;AAC1D,SAAO;AACT;AAEA,SAAS,SAAS,MAAkB,MAAuB;AACzD,MAAI,KAAK,WAAW,QAAQ;AAC1B,mBAAe,MAAwC,KAAK,MAAM;AAClE;AAAA,EACF;AACA,eAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AACjC;AAEA,SAAS,UAAU,MAAkB,KAAqB;AACxD,MAAI,eAAe,UAAU;AAC3B,iBAAa,eAAe,IAAI,SAAS,KAAK,aAAa,QAAG,CAAC;AAC/D,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,eAAa,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,iBAAiB,SAAS,mBAAmB,EAAE,CAAC;AACzF,UAAQ,KAAK,CAAC;AAChB;AAMA,eAAsB,eAAe,MAAiC;AACpE,MAAI,cAAc,IAAI,EAAG;AACzB,QAAM,SAAS,iBAAiB,IAAI;AACpC,MAAI;AACF,UAAM,OAAO,MAAM,OAAkB,KAAK,MAAM,MAAM;AACtD,QAAI,KAAK,YAAY,KAAK,eAAe,QAAW;AAClD,eAAS,KAAK,eAAe,KAAK,UAAU,MAAM,KAAK,UAAU;AAAA,IACnE;AACA,aAAS,MAAM,IAAI;AAAA,EACrB,SAAS,KAAK;AACZ,cAAU,MAAM,GAAG;AAAA,EACrB;AACF;","names":[]}

package/dist/chunk-XIGIJJSF.js

@@ -0,0 +1,66 @@
+import {
+  canvasOutputsRoot
+} from "./chunk-HDHWIEJJ.js";
+import {
+  optionalChatId
+} from "./chunk-O6QKCJE4.js";
+
+// src/commands/canvas/creative-limit.ts
+import { existsSync } from "fs";
+import { mkdir, readdir, writeFile } from "fs/promises";
+import path from "path";
+var NEW_CREATIVES_PER_CHAT = 10;
+function claimNewCreative(made, slug) {
+  if (made.includes(slug)) return { allowed: true, count: made.length };
+  if (made.length >= NEW_CREATIVES_PER_CHAT) return { allowed: false, count: made.length };
+  return { allowed: true, count: made.length + 1 };
+}
+function chatDir(canvasRoot, chatId) {
+  return path.join(canvasRoot, ".creative-limit", (chatId ?? "no-chat").replace(/[^A-Za-z0-9_-]/g, "_"));
+}
+async function madeInChat(dir) {
+  return readdir(dir).catch(() => []);
+}
+async function claimNewCreativeInWorkspace(canvasRoot, slug, chatId, definitionPath, exists = existsSync) {
+  const dir = chatDir(canvasRoot, chatId);
+  const made = await madeInChat(dir);
+  if (!made.includes(slug) && exists(definitionPath)) return { allowed: true, count: made.length };
+  const claim = claimNewCreative(made, slug);
+  if (claim.allowed && !made.includes(slug)) {
+    try {
+      await mkdir(dir, { recursive: true });
+      await writeFile(path.join(dir, slug), "", { flag: "wx" });
+    } catch {
+    }
+  }
+  return claim;
+}
+function creativeLimitRefusal(slug) {
+  return {
+    ok: false,
+    error: {
+      code: "CREATIVE_LIMIT",
+      message: `${slug} would be new creative number ${NEW_CREATIVES_PER_CHAT + 1} in this chat. A chat makes at most ${NEW_CREATIVES_PER_CHAT} new creatives.`,
+      fix: `Build nothing more. Finish and show the ${NEW_CREATIVES_PER_CHAT} you have, and tell the person in one line that a chat makes up to ${NEW_CREATIVES_PER_CHAT} new creatives, so the rest go in a new chat. Editing or resizing the ones already made still works here. Working as a subagent: return now and say the limit was reached.`
+    }
+  };
+}
+async function enforceNewCreativeLimit(slug, canvasPath) {
+  const claim = await claimNewCreativeInWorkspace(
+    canvasOutputsRoot(canvasPath),
+    slug,
+    optionalChatId() ?? null,
+    path.join(path.dirname(path.resolve(canvasPath)), "_definition.md")
+  );
+  if (claim.allowed) return;
+  process.stderr.write(`${JSON.stringify(creativeLimitRefusal(slug), null, 2)}
+`);
+  process.exit(2);
+}
+
+export {
+  claimNewCreativeInWorkspace,
+  creativeLimitRefusal,
+  enforceNewCreativeLimit
+};
+//# sourceMappingURL=chunk-XIGIJJSF.js.map

package/dist/chunk-XIGIJJSF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/creative-limit.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { mkdir, readdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { optionalChatId } from \"../../env.ts\";\nimport { canvasOutputsRoot } from \"./normalize-paths.ts\";\n\n// How many new creatives one chat may scaffold.\n//\n// A spend brake, not a marketing rule: the batches people actually ask for stay well under\n// it (production, Sept 2026: the largest was 10, and it took 137 minutes at ~200 credits a\n// creative). Past it, the ask is far more likely a slip (\"100\" for \"10\", a looping agent)\n// than a plan, and each one bills the platform. Scaffolding is where a creative is born, so\n// the brake sits there, before any billed pass. Editing, resizing or re-scaffolding a\n// creative that already existed is not new work and never counts.\n//\n// One marker file per creative under `canvas/.creative-limit/<chat>/`, created with `wx`,\n// like the render budget's file per slug: producers scaffold in parallel, and a shared\n// read-change-write file loses claims (or reads back empty mid-write and restarts at zero).\n// Counting then creating can overshoot by the claims in flight at once (one wave), never\n// reset. Keyed by chat so a workspace reused by another chat starts over.\n\nexport const NEW_CREATIVES_PER_CHAT = 10;\n\n/** Whether `slug` may be born in a chat that has already made `made`. Pure. */\nexport function claimNewCreative(made: readonly string[], slug: string): { allowed: boolean; count: number } {\n  if (made.includes(slug)) return { allowed: true, count: made.length };\n  if (made.length >= NEW_CREATIVES_PER_CHAT) return { allowed: false, count: made.length };\n  return { allowed: true, count: made.length + 1 };\n}\n\nfunction chatDir(canvasRoot: string, chatId: string | null): string {\n  return path.join(canvasRoot, \".creative-limit\", (chatId ?? \"no-chat\").replace(/[^A-Za-z0-9_-]/g, \"_\"));\n}\n\nasync function madeInChat(dir: string): Promise<string[]> {\n  return readdir(dir).catch(() => []);\n}\n\n/**\n * Count `slug` as a creative born in this chat, or refuse it. A creative whose folder already\n * held a `_definition.md` existed before and is let through uncounted. An unwritable marker\n * never blocks: the limit is a brake on slips, not a lock.\n */\nexport async function claimNewCreativeInWorkspace(\n  canvasRoot: string,\n  slug: string,\n  chatId: string | null,\n  definitionPath: string,\n  exists: (p: string) => boolean = existsSync,\n): Promise<{ allowed: boolean; count: number }> {\n  const dir = chatDir(canvasRoot, chatId);\n  const made = await madeInChat(dir);\n  if (!made.includes(slug) && exists(definitionPath)) return { allowed: true, count: made.length };\n  const claim = claimNewCreative(made, slug);\n  if (claim.allowed && !made.includes(slug)) {\n    try {\n      await mkdir(dir, { recursive: true });\n      await writeFile(path.join(dir, slug), \"\", { flag: \"wx\" });\n    } catch {\n      // Already claimed by a parallel scaffold of the same slug, or unwritable: best-effort.\n    }\n  }\n  return claim;\n}\n\n/** What a scaffold answers past the limit: what to tell the person, not \"try again\". */\nexport function creativeLimitRefusal(slug: string): { ok: false; error: { code: string; message: string; fix: string } } {\n  return {\n    ok: false,\n    error: {\n      code: \"CREATIVE_LIMIT\",\n      message: `${slug} would be new creative number ${NEW_CREATIVES_PER_CHAT + 1} in this chat. A chat makes at most ${NEW_CREATIVES_PER_CHAT} new creatives.`,\n      fix: `Build nothing more. Finish and show the ${NEW_CREATIVES_PER_CHAT} you have, and tell the person in one line that a chat makes up to ${NEW_CREATIVES_PER_CHAT} new creatives, so the rest go in a new chat. Editing or resizing the ones already made still works here. Working as a subagent: return now and say the limit was reached.`,\n    },\n  };\n}\n\n/**\n * The scaffold commands' gate: refuse `slug` before any billed pass when it would be one new\n * creative too many for this chat. Exits the process with the refusal; returns when allowed.\n */\nexport async function enforceNewCreativeLimit(slug: string, canvasPath: string): Promise<void> {\n  const claim = await claimNewCreativeInWorkspace(\n    canvasOutputsRoot(canvasPath),\n    slug,\n    optionalChatId() ?? null,\n    path.join(path.dirname(path.resolve(canvasPath)), \"_definition.md\"),\n  );\n  if (claim.allowed) return;\n  process.stderr.write(`${JSON.stringify(creativeLimitRefusal(slug), null, 2)}\\n`);\n  process.exit(2);\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,OAAO,SAAS,iBAAiB;AAC1C,OAAO,UAAU;AAmBV,IAAM,yBAAyB;AAG/B,SAAS,iBAAiB,MAAyB,MAAmD;AAC3G,MAAI,KAAK,SAAS,IAAI,EAAG,QAAO,EAAE,SAAS,MAAM,OAAO,KAAK,OAAO;AACpE,MAAI,KAAK,UAAU,uBAAwB,QAAO,EAAE,SAAS,OAAO,OAAO,KAAK,OAAO;AACvF,SAAO,EAAE,SAAS,MAAM,OAAO,KAAK,SAAS,EAAE;AACjD;AAEA,SAAS,QAAQ,YAAoB,QAA+B;AAClE,SAAO,KAAK,KAAK,YAAY,oBAAoB,UAAU,WAAW,QAAQ,mBAAmB,GAAG,CAAC;AACvG;AAEA,eAAe,WAAW,KAAgC;AACxD,SAAO,QAAQ,GAAG,EAAE,MAAM,MAAM,CAAC,CAAC;AACpC;AAOA,eAAsB,4BACpB,YACA,MACA,QACA,gBACA,SAAiC,YACa;AAC9C,QAAM,MAAM,QAAQ,YAAY,MAAM;AACtC,QAAM,OAAO,MAAM,WAAW,GAAG;AACjC,MAAI,CAAC,KAAK,SAAS,IAAI,KAAK,OAAO,cAAc,EAAG,QAAO,EAAE,SAAS,MAAM,OAAO,KAAK,OAAO;AAC/F,QAAM,QAAQ,iBAAiB,MAAM,IAAI;AACzC,MAAI,MAAM,WAAW,CAAC,KAAK,SAAS,IAAI,GAAG;AACzC,QAAI;AACF,YAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AACpC,YAAM,UAAU,KAAK,KAAK,KAAK,IAAI,GAAG,IAAI,EAAE,MAAM,KAAK,CAAC;AAAA,IAC1D,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,qBAAqB,MAAoF;AACvH,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS,GAAG,IAAI,iCAAiC,yBAAyB,CAAC,uCAAuC,sBAAsB;AAAA,MACxI,KAAK,2CAA2C,sBAAsB,sEAAsE,sBAAsB;AAAA,IACpK;AAAA,EACF;AACF;AAMA,eAAsB,wBAAwB,MAAc,YAAmC;AAC7F,QAAM,QAAQ,MAAM;AAAA,IAClB,kBAAkB,UAAU;AAAA,IAC5B;AAAA,IACA,eAAe,KAAK;AAAA,IACpB,KAAK,KAAK,KAAK,QAAQ,KAAK,QAAQ,UAAU,CAAC,GAAG,gBAAgB;AAAA,EACpE;AACA,MAAI,MAAM,QAAS;AACnB,UAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,qBAAqB,IAAI,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AAC/E,UAAQ,KAAK,CAAC;AAChB;","names":[]}