@koda-sl/baker-cli 0.512.0 → 0.514.0

package/dist/create-3WOZO2XT.js

@@ -0,0 +1,239 @@
+import {
+  holdWorkspaceSpend
+} from "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import {
+  askJev
+} from "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import {
+  ACTION_PRIORITIES,
+  buildCreateHints,
+  failApi,
+  failValidation,
+  generateTempId,
+  parsePriority,
+  parseTagList
+} from "./chunk-UDIEKCIR.js";
+import {
+  actionTempIdSchema
+} from "./chunk-PC3FJEZH.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  requireChatId
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/create.ts
+import { defineCommand } from "citty";
+
+// src/commands/actions/advisory.ts
+var EXECUTABLE_SURFACES = [
+  "ask-user",
+  "analysis",
+  "ads-write",
+  "tag-manager",
+  "site-tags",
+  "landing",
+  "flow"
+];
+var SCHEDULED_HINT = 'This reads as recurring/scheduled work. If it should run on a cadence or a future date, create a Scheduled agent instead \u2014 baker scheduled-agents create --cron "0 9 * * MON" (or --run-at, or --trigger for a reaction rather than a clock; guide: `__tooling__/docs/tools/baker/scheduled-agents.md`). Do not capture "set up a schedule" as a Work Action.';
+var SURFACES = {
+  "ask-user": {
+    questions: [
+      "Does `task` say the work cannot go ahead until the client or user gives or confirms one specific value, such as a production domain, an account ID or credentials? Work that is blocked for any other reason is not."
+    ],
+    hint: "This is a missing input, not blocked work. Ask for it with AskUserQuestion (one question), then do the work in the same turn \u2014 filing the Task AND asking the question is the same request twice."
+  },
+  analysis: {
+    questions: [
+      "Is the work `task` names itself an investigation: to audit, review, analyse, verify, check, document or research something, where the result is a finding rather than a change?"
+    ],
+    hint: "This names the analysis itself \u2014 investigating, auditing and documenting are work you do now, not work you file. Run it in this chat and deliver the finding; a Task is for a fix something genuinely blocks (bar: `__tooling__/docs/tools/baker/actions.md`)."
+  },
+  "ads-write": {
+    // The platform often goes unnamed ("6 new WhatsApp campaigns" are Google Ads campaigns).
+    questions: [
+      "Is `task` a change to the settings of paid ad campaigns or ad sets: location targeting, ad schedule, audiences or audience signals, bids, tracking URL templates or final URLs?",
+      "Is `task` setting, applying, raising, lowering or capping the budget of paid ad campaigns or ad sets? Approving a budget is not.",
+      "Is `task` a change to what paid ads say or show: ad copy, search ad (RSA) headlines or descriptions, display paths, claims in the ads, callouts, sitelinks, structured snippets or other ad extensions?",
+      "Is `task` a change to the keywords of paid search campaigns: adding keywords, match types or negative keywords? Work that needs another company's permission first is not.",
+      "Is `task` pausing, launching, enabling, duplicating, pruning, reweighting or restructuring paid ad campaigns, ad sets or ads, or labelling them? Getting a decision or an approval is not."
+    ],
+    hint: "This is an ad-platform change the write surface covers \u2014 stage it now with `baker ads google|meta|linkedin` and it applies at publish (guides: `__tooling__/docs/tools/baker/ads-google.md`, `__tooling__/docs/tools/baker/ads-meta.md`, `__tooling__/docs/tools/baker/ads-linkedin.md`). Staging is not going live."
+  },
+  "tag-manager": {
+    questions: [
+      "Is `task` a change inside the Google Tag Manager container: its tags, triggers, variables, data layer events, consent settings, GA4 events or conversion measurement? Server-side tagging, or hosting, is not."
+    ],
+    hint: "This is a change inside the GTM container \u2014 `baker tag-manager` stages it now and it applies at publish (guide: `__tooling__/docs/tools/baker/tag-manager.md`). Stage it instead of filing it, and if several container fixes really are blocked, they belong in ONE Task, not one per finding."
+  },
+  "site-tags": {
+    questions: [
+      "Is `task` installing, configuring or removing a tracking script, pixel or tag on the website pages (a Meta pixel and its Conversions API events, Clarity, Hotjar, a HubSpot tracking code, a LinkedIn Insight tag)? A server-side setup on the company's own domain is not."
+    ],
+    hint: "This is a tag or script on the site \u2014 it goes through the `request_tag_input` approval form in this chat, which also collects any secret values (guide: `__tooling__/docs/tools/baker/tags.md`). Show the form instead of filing a Task."
+  },
+  landing: {
+    questions: [
+      "Is `task` building or editing a page of the website or a landing page: its copy, hero, headline, sections or layout? A headline of an ad, or a page only mentioned as the cause of another problem, is not."
+    ],
+    hint: "This is a page change \u2014 build it in this chat with the `/landing` skill. Only file it if something outside the page blocks the work."
+  },
+  flow: {
+    questions: ["Is `task` changing how a form behaves: its steps, branching logic, or the redirect after it is sent?"],
+    hint: "This is form behaviour \u2014 change it in this chat with the `/flow-builder` skill. Only file it if something outside the form blocks the work."
+  }
+};
+var SCHEDULED_QUESTIONS = [
+  "Does `task` ask for work to be done again and again on a schedule (every day, every week, each Monday, monthly)? A month or period that only says what the work is about is not.",
+  "Does `task` ask to be reminded, or for work to be done, at a later date or moment (before a launch, on a given day)? A month or date that only names the period the work is about is not."
+];
+var ROUTING_BANDS = { scheduled: 0.5, surface: 0.5 };
+var jevTaskJudge = async (task) => {
+  const groups = [
+    SCHEDULED_QUESTIONS,
+    ...EXECUTABLE_SURFACES.map((s) => SURFACES[s].questions)
+  ];
+  const spent = [];
+  const answers = await askJev(
+    groups.flat().map((question) => ({ instructions: { task, question } })),
+    (usage) => spent.push(usage)
+  );
+  await holdWorkspaceSpend(spent);
+  if (answers === null) return null;
+  let next = 0;
+  const [scheduled = 0, ...surfaces] = groups.map((group) => Math.max(...group.map(() => answers[next++] ?? 0)));
+  return {
+    scheduled,
+    surfaces: Object.fromEntries(EXECUTABLE_SURFACES.map((s, i) => [s, surfaces[i] ?? 0]))
+  };
+};
+function hintFor(reading) {
+  if (reading.scheduled >= ROUTING_BANDS.scheduled) return { kind: "scheduled", hint: SCHEDULED_HINT };
+  if (reading.surfaces["ask-user"] >= ROUTING_BANDS.surface) {
+    return { kind: "executable", surface: "ask-user", hint: SURFACES["ask-user"].hint };
+  }
+  let best = null;
+  for (const surface of EXECUTABLE_SURFACES) {
+    const p = reading.surfaces[surface];
+    if (p >= ROUTING_BANDS.surface && (best === null || p > best.p)) best = { surface, p };
+  }
+  return best ? { kind: "executable", surface: best.surface, hint: SURFACES[best.surface].hint } : null;
+}
+function taskText(name, description) {
+  return description.trim() ? `${name.trim()}
+
+${description.trim()}` : name.trim();
+}
+async function advisoryHint(name, description, judge) {
+  const reading = await judge(taskText(name, description)).catch(() => null);
+  return reading === null ? null : hintFor(reading);
+}
+
+// src/commands/actions/create.ts
+registerSchema({
+  command: "actions.create",
+  description: "Stage creation of a new action (applies when the chat is published). Returns a tempId you can use to link in the same draft. Pass --tags (REQUIRED \u2014 run `baker actions tags list` for the taxonomy) and --priority (one of urgent|high|medium|low \u2014 drives the dependency-aware 'Do first' ordering). After creating, check if this action blocks or is blocked by other actions and wire dependencies with `baker actions link`.",
+  args: {
+    name: { type: "string", description: "Action name (short, action-verb, \u22646 words)", required: true },
+    description: {
+      type: "string",
+      description: "Context-complete description in markdown: what / why / where / done-when. Use `##` headings for those sections, `-` bullets for lists of items, and `**bold**` for the figures that drive the decision. Anything longer than a couple of sentences needs headings \u2014 it is read in a narrow panel.",
+      required: false
+    },
+    tags: {
+      type: "string",
+      description: "Comma-separated tag slugs (e.g. google-ads,audit-finding). Must be known \u2014 see `baker actions tags list`.",
+      required: false
+    },
+    priority: {
+      type: "string",
+      description: `User priority for the do-first ordering. One of: ${ACTION_PRIORITIES.join(", ")}.`,
+      required: false
+    },
+    "temp-id": {
+      type: "string",
+      description: "Custom tempId \u2014 must start with `temp_` (e.g. temp_hero_copy). Auto-generated if omitted; omitting it is fine.",
+      required: false
+    }
+  }
+});
+var createCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: 'Stage a new action. Applies when the chat is published. Example: baker actions create --name "Build hero"'
+  },
+  args: {
+    name: { type: "string", description: "Action name", required: false },
+    description: { type: "string", description: "Description", required: false, default: "" },
+    tags: { type: "string", description: "Comma-separated tag slugs (see `baker actions tags list`)", required: false },
+    priority: { type: "string", description: `User priority: ${ACTION_PRIORITIES.join("|")}`, required: false },
+    "temp-id": { type: "string", description: "Optional custom tempId (must start with `temp_`)", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const name = args.name;
+      if (!name || name.trim().length === 0) {
+        failValidation("--name is required.");
+      }
+      const customTempId = args["temp-id"];
+      if (customTempId) {
+        const parsed = actionTempIdSchema.safeParse(customTempId);
+        if (!parsed.success) {
+          failValidation(parsed.error.issues[0]?.message ?? "Invalid --temp-id.");
+        }
+      }
+      const chatId = requireChatId();
+      const tempId = customTempId || generateTempId();
+      const tags = parseTagList(args.tags);
+      const priority = parsePriority(args.priority, { allowClear: false });
+      const description = args.description ?? "";
+      const [response, advisory] = await Promise.all([
+        apiPost("/api/actions/create", {
+          chatId,
+          tempId,
+          name,
+          description,
+          ...tags ? { tags } : {},
+          ...priority !== void 0 && priority !== null ? { priority } : {}
+        }),
+        advisoryHint(name, description, jevTaskJudge)
+      ]);
+      writeJson({
+        ...response,
+        hints: buildCreateHints({
+          advisory,
+          name,
+          description,
+          tempId,
+          tags,
+          prioritySet: priority !== void 0,
+          draftCreateCount: response.data.draftCreateCount ?? 0
+        })
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  createCommand
+};
+//# sourceMappingURL=create-3WOZO2XT.js.map

package/dist/create-3WOZO2XT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/actions/create.ts","../src/commands/actions/advisory.ts"],"sourcesContent":["import { type ActionsCreateResponse, actionTempIdSchema } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { requireChatId } from \"../../env.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { advisoryHint, jevTaskJudge } from \"./advisory.ts\";\nimport {\n  ACTION_PRIORITIES,\n  buildCreateHints,\n  failApi,\n  failValidation,\n  generateTempId,\n  parsePriority,\n  parseTagList,\n} from \"./shared.ts\";\n\nregisterSchema({\n  command: \"actions.create\",\n  description:\n    \"Stage creation of a new action (applies when the chat is published). Returns a tempId you can use to link in the same draft. Pass --tags (REQUIRED — run `baker actions tags list` for the taxonomy) and --priority (one of urgent|high|medium|low — drives the dependency-aware 'Do first' ordering). After creating, check if this action blocks or is blocked by other actions and wire dependencies with `baker actions link`.\",\n  args: {\n    name: { type: \"string\", description: \"Action name (short, action-verb, ≤6 words)\", required: true },\n    description: {\n      type: \"string\",\n      description:\n        \"Context-complete description in markdown: what / why / where / done-when. Use `##` headings for those sections, `-` bullets for lists of items, and `**bold**` for the figures that drive the decision. Anything longer than a couple of sentences needs headings — it is read in a narrow panel.\",\n      required: false,\n    },\n    tags: {\n      type: \"string\",\n      description:\n        \"Comma-separated tag slugs (e.g. google-ads,audit-finding). Must be known — see `baker actions tags list`.\",\n      required: false,\n    },\n    priority: {\n      type: \"string\",\n      description: `User priority for the do-first ordering. One of: ${ACTION_PRIORITIES.join(\", \")}.`,\n      required: false,\n    },\n    \"temp-id\": {\n      type: \"string\",\n      description:\n        \"Custom tempId — must start with `temp_` (e.g. temp_hero_copy). Auto-generated if omitted; omitting it is fine.\",\n      required: false,\n    },\n  },\n});\n\nexport const createCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description:\n      'Stage a new action. Applies when the chat is published. Example: baker actions create --name \"Build hero\"',\n  },\n  args: {\n    name: { type: \"string\", description: \"Action name\", required: false },\n    description: { type: \"string\", description: \"Description\", required: false, default: \"\" },\n    tags: { type: \"string\", description: \"Comma-separated tag slugs (see `baker actions tags list`)\", required: false },\n    priority: { type: \"string\", description: `User priority: ${ACTION_PRIORITIES.join(\"|\")}`, required: false },\n    \"temp-id\": { type: \"string\", description: \"Optional custom tempId (must start with `temp_`)\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const name = args.name as string | undefined;\n      if (!name || name.trim().length === 0) {\n        failValidation(\"--name is required.\");\n      }\n      // Check the args the agent typed before anything about the environment:\n      // a bad --temp-id must report itself, not hide behind a missing chat id.\n      // Refusing here rather than at publish is the point — `temp_` is what\n      // tells a staged Task apart from a published action id in every later\n      // command, and by publish time the draft is already written.\n      const customTempId = args[\"temp-id\"] as string | undefined;\n      if (customTempId) {\n        const parsed = actionTempIdSchema.safeParse(customTempId);\n        if (!parsed.success) {\n          failValidation(parsed.error.issues[0]?.message ?? \"Invalid --temp-id.\");\n        }\n      }\n      const chatId = requireChatId();\n      const tempId = customTempId || generateTempId();\n      const tags = parseTagList(args.tags);\n      // Create doesn't support clearing — there's nothing to clear yet. Reject\n      // \"none\"/empty so the agent doesn't think it just unset something.\n      const priority = parsePriority(args.priority, { allowClear: false });\n      const description = (args.description as string) ?? \"\";\n      const [response, advisory] = await Promise.all([\n        apiPost<ActionsCreateResponse>(\"/api/actions/create\", {\n          chatId,\n          tempId,\n          name,\n          description,\n          ...(tags ? { tags } : {}),\n          ...(priority !== undefined && priority !== null ? { priority } : {}),\n        }),\n        advisoryHint(name, description, jevTaskJudge),\n      ]);\n\n      writeJson({\n        ...response,\n        hints: buildCreateHints({\n          advisory,\n          name,\n          description,\n          tempId,\n          tags,\n          prioritySet: priority !== undefined,\n          draftCreateCount: response.data.draftCreateCount ?? 0,\n        }),\n      });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n","/**\n * The one advisory hint `baker actions create` returns about the Task itself: it reads as\n * recurring work (a Scheduled agent), or as work a surface of this chat executes now. A Task is\n * the exception, not the default. The agent names Tasks in the marketer's language, so the\n * decision model reads the name and description in whatever language they are in\n * (docs/decision-model.md). Advisory only: a wrong hint costs one line, a missing one costs a\n * Task that should not exist.\n */\nimport { askJev } from \"../../engine/nodes/local/lib/jev.ts\";\nimport type { ReviewUsage } from \"../../engine/nodes/local/lib/render-review.ts\";\nimport { holdWorkspaceSpend } from \"../canvas/unbilled-spend.ts\";\n\nexport const EXECUTABLE_SURFACES = [\n  \"ask-user\",\n  \"analysis\",\n  \"ads-write\",\n  \"tag-manager\",\n  \"site-tags\",\n  \"landing\",\n  \"flow\",\n] as const;\nexport type ExecutableSurface = (typeof EXECUTABLE_SURFACES)[number];\n\nexport const SCHEDULED_HINT =\n  'This reads as recurring/scheduled work. If it should run on a cadence or a future date, create a Scheduled agent instead — baker scheduled-agents create --cron \"0 9 * * MON\" (or --run-at, or --trigger for a reaction rather than a clock; guide: `__tooling__/docs/tools/baker/scheduled-agents.md`). Do not capture \"set up a schedule\" as a Work Action.';\n\n// A surface is asked as one or more questions, the highest kept: one judgment per question reads\n// better than one long question listing everything a surface covers.\ntype Surface = { questions: readonly string[]; hint: string };\n\nconst SURFACES: Readonly<Record<ExecutableSurface, Surface>> = {\n  \"ask-user\": {\n    questions: [\n      \"Does `task` say the work cannot go ahead until the client or user gives or confirms one specific value, such as a production domain, an account ID or credentials? Work that is blocked for any other reason is not.\",\n    ],\n    hint: \"This is a missing input, not blocked work. Ask for it with AskUserQuestion (one question), then do the work in the same turn — filing the Task AND asking the question is the same request twice.\",\n  },\n  analysis: {\n    questions: [\n      \"Is the work `task` names itself an investigation: to audit, review, analyse, verify, check, document or research something, where the result is a finding rather than a change?\",\n    ],\n    hint: \"This names the analysis itself — investigating, auditing and documenting are work you do now, not work you file. Run it in this chat and deliver the finding; a Task is for a fix something genuinely blocks (bar: `__tooling__/docs/tools/baker/actions.md`).\",\n  },\n  \"ads-write\": {\n    // The platform often goes unnamed (\"6 new WhatsApp campaigns\" are Google Ads campaigns).\n    questions: [\n      \"Is `task` a change to the settings of paid ad campaigns or ad sets: location targeting, ad schedule, audiences or audience signals, bids, tracking URL templates or final URLs?\",\n      \"Is `task` setting, applying, raising, lowering or capping the budget of paid ad campaigns or ad sets? Approving a budget is not.\",\n      \"Is `task` a change to what paid ads say or show: ad copy, search ad (RSA) headlines or descriptions, display paths, claims in the ads, callouts, sitelinks, structured snippets or other ad extensions?\",\n      \"Is `task` a change to the keywords of paid search campaigns: adding keywords, match types or negative keywords? Work that needs another company's permission first is not.\",\n      \"Is `task` pausing, launching, enabling, duplicating, pruning, reweighting or restructuring paid ad campaigns, ad sets or ads, or labelling them? Getting a decision or an approval is not.\",\n    ],\n    hint: \"This is an ad-platform change the write surface covers — stage it now with `baker ads google|meta|linkedin` and it applies at publish (guides: `__tooling__/docs/tools/baker/ads-google.md`, `__tooling__/docs/tools/baker/ads-meta.md`, `__tooling__/docs/tools/baker/ads-linkedin.md`). Staging is not going live.\",\n  },\n  \"tag-manager\": {\n    questions: [\n      \"Is `task` a change inside the Google Tag Manager container: its tags, triggers, variables, data layer events, consent settings, GA4 events or conversion measurement? Server-side tagging, or hosting, is not.\",\n    ],\n    hint: \"This is a change inside the GTM container — `baker tag-manager` stages it now and it applies at publish (guide: `__tooling__/docs/tools/baker/tag-manager.md`). Stage it instead of filing it, and if several container fixes really are blocked, they belong in ONE Task, not one per finding.\",\n  },\n  \"site-tags\": {\n    questions: [\n      \"Is `task` installing, configuring or removing a tracking script, pixel or tag on the website pages (a Meta pixel and its Conversions API events, Clarity, Hotjar, a HubSpot tracking code, a LinkedIn Insight tag)? A server-side setup on the company's own domain is not.\",\n    ],\n    hint: \"This is a tag or script on the site — it goes through the `request_tag_input` approval form in this chat, which also collects any secret values (guide: `__tooling__/docs/tools/baker/tags.md`). Show the form instead of filing a Task.\",\n  },\n  landing: {\n    questions: [\n      \"Is `task` building or editing a page of the website or a landing page: its copy, hero, headline, sections or layout? A headline of an ad, or a page only mentioned as the cause of another problem, is not.\",\n    ],\n    hint: \"This is a page change — build it in this chat with the `/landing` skill. Only file it if something outside the page blocks the work.\",\n  },\n  flow: {\n    questions: [\"Is `task` changing how a form behaves: its steps, branching logic, or the redirect after it is sent?\"],\n    hint: \"This is form behaviour — change it in this chat with the `/flow-builder` skill. Only file it if something outside the form blocks the work.\",\n  },\n};\n\n// Two shapes of the same answer, the higher kept.\nconst SCHEDULED_QUESTIONS = [\n  \"Does `task` ask for work to be done again and again on a schedule (every day, every week, each Monday, monthly)? A month or period that only says what the work is about is not.\",\n  \"Does `task` ask to be reminded, or for work to be done, at a later date or moment (before a launch, on a given day)? A month or date that only names the period the work is about is not.\",\n];\n\n/**\n * The bands, measured 2026-10-07 on 74 Task names and descriptions, verbatim from production chats\n * and in five languages (scripts/task-routing-evals, 74/74 on three runs). Recurring or reminder\n * work scored 0.66 or more and one-off work 0.38 or less; the surface that executes a Task 0.59 or\n * more, and Tasks no surface executes (an approval, server-side hosting, a CRM integration) 0.40\n * or less on every surface.\n */\nexport const ROUTING_BANDS = { scheduled: 0.5, surface: 0.5 } as const;\n\n/** The decision model's reading of one Task: the probability it is recurring, and that each surface executes it. */\nexport type TaskReading = { scheduled: number; surfaces: Readonly<Record<ExecutableSurface, number>> };\n\n/** Reads a Task; null when no judgment came back. */\nexport type TaskJudge = (task: string) => Promise<TaskReading | null>;\n\n/** The decision model as the judge: one Noul per question, all in one request. */\nexport const jevTaskJudge: TaskJudge = async (task) => {\n  const groups: ReadonlyArray<readonly string[]> = [\n    SCHEDULED_QUESTIONS,\n    ...EXECUTABLE_SURFACES.map((s) => SURFACES[s].questions),\n  ];\n  const spent: ReviewUsage[] = [];\n  const answers = await askJev(\n    groups.flat().map((question) => ({ instructions: { task, question } })),\n    (usage) => spent.push(usage),\n  );\n  await holdWorkspaceSpend(spent);\n  if (answers === null) return null;\n  let next = 0;\n  const [scheduled = 0, ...surfaces] = groups.map((group) => Math.max(...group.map(() => answers[next++] ?? 0)));\n  return {\n    scheduled,\n    surfaces: Object.fromEntries(EXECUTABLE_SURFACES.map((s, i) => [s, surfaces[i] ?? 0])) as Record<\n      ExecutableSurface,\n      number\n    >,\n  };\n};\n\nexport type AdvisoryHint =\n  | { kind: \"scheduled\"; hint: string }\n  | { kind: \"executable\"; surface: ExecutableSurface; hint: string };\n\n/**\n * One advisory hint, never two. A recurring GTM review is both; the scheduled redirect is the more\n * specific instruction, and two hints would tell the agent to do different things with one Task.\n * Pure.\n */\nexport function hintFor(reading: TaskReading): AdvisoryHint | null {\n  if (reading.scheduled >= ROUTING_BANDS.scheduled) return { kind: \"scheduled\", hint: SCHEDULED_HINT };\n  // A missing input beats the surface next to it: asking and then doing is one turn.\n  if (reading.surfaces[\"ask-user\"] >= ROUTING_BANDS.surface) {\n    return { kind: \"executable\", surface: \"ask-user\", hint: SURFACES[\"ask-user\"].hint };\n  }\n  let best: { surface: ExecutableSurface; p: number } | null = null;\n  for (const surface of EXECUTABLE_SURFACES) {\n    const p = reading.surfaces[surface];\n    if (p >= ROUTING_BANDS.surface && (best === null || p > best.p)) best = { surface, p };\n  }\n  return best ? { kind: \"executable\", surface: best.surface, hint: SURFACES[best.surface].hint } : null;\n}\n\n/** The Task as the decision model reads it: its name, then its description. */\nexport function taskText(name: string, description: string): string {\n  return description.trim() ? `${name.trim()}\\n\\n${description.trim()}` : name.trim();\n}\n\n/** The advisory hint for a staged Task; none when the decision model gives no judgment. */\nexport async function advisoryHint(name: string, description: string, judge: TaskJudge): Promise<AdvisoryHint | null> {\n  const reading = await judge(taskText(name, description)).catch(() => null);\n  return reading === null ? null : hintFor(reading);\n}\n\n/** Every hint above points the agent somewhere; a test asserts each referenced doc still exists. */\nexport function executableSurfaceHints(): string[] {\n  return EXECUTABLE_SURFACES.map((s) => SURFACES[s].hint);\n}\n"],"mappings":"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","names":[]}

package/dist/create-7IFYLX7P.js

@@ -0,0 +1,210 @@
+import {
+  buildProfilePatch
+} from "./chunk-IJMWEO4P.js";
+import {
+  chatIdFromEnv,
+  creationHints,
+  failAvatarApi,
+  failValidation,
+  parseFaceChoice
+} from "./chunk-OLQSKCMO.js";
+import {
+  writeAvatars
+} from "./chunk-WHBFXR6F.js";
+import {
+  AVATAR_HANDLE_PATTERN
+} from "./chunk-PC3FJEZH.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/create.ts
+import { defineCommand } from "citty";
+function parseImageIds(value) {
+  if (typeof value !== "string") return void 0;
+  const ids = value.split(",").map((id) => id.trim()).filter((id) => id.length > 0);
+  return ids.length > 0 ? [...new Set(ids)] : void 0;
+}
+registerSchema({
+  command: "avatars.create",
+  description: 'Cast a new avatar \u2014 a reusable AI presenter this company can put in images and video. Start here: `baker avatars create --name "Marta" --subject "woman in her early 40s, shoulder-length dark hair, warm brown eyes, light olive skin"`. --subject is the identity: describe ONE person plainly (age, build, hair, skin, face) with no scene, no lighting and no wardrobe, because it is copied word for word into every prompt that renders them. Two kinds: invented from your description (default), or built from photographs of a real person (--source-image with --likeness-confirmed, which is the company stating it may use that person\'s image in advertising). For a real person the copy NAMES \u2014 a testimonial author, the founder, a team member \u2014 use `baker avatars research "<name>, <role> at <company>" --create` instead: it finds their photos and builds the avatar itself. Returns immediately with status `generating` \u2014 the identity sheet is a ~30s render that settles in the background.',
+  args: {
+    name: { type: "string", description: 'Display name, e.g. "Marta"', required: true },
+    handle: {
+      type: "string",
+      description: 'Mention handle (lowercase, dashes), e.g. "marta". Derived from the name when omitted.',
+      required: false
+    },
+    subject: {
+      type: "string",
+      description: "The identity, reused verbatim in every render: one person, plainly described (age, build, hair, skin, face). No scene, no lighting, no camera, no wardrobe \u2014 those belong in the render prompt or in --wardrobe/--setting.",
+      required: true
+    },
+    persona: { type: "string", description: "Who they are on camera \u2014 role, attitude, energy", required: false },
+    speech: { type: "string", description: "How they speak \u2014 pace, register, verbal habits", required: false },
+    accent: {
+      type: "string",
+      description: `Where their VOICE is from, as a place: 'Spanish from Spain, Madrid accent', 'Mexican Spanish', 'British English, London'. Name the region \u2014 an adjective like 'clear Spanish accent' is read by the video model as NO accent, and the clip comes out sounding like nowhere. Default to the language the USER is writing to you in, always: they are describing an ad for their own market, and an avatar that answers them in another language is unusable however good it looks. Never take this from how the person LOOKS \u2014 'aspecto europeo', 'Nordic', 'Mediterranean' describe a face and belong in --subject. Read literally, that mistake shipped an ad for a Spanish client with --accent "German", and the clip came back spoken in German.`,
+      required: false
+    },
+    motion: { type: "string", description: "Body language and gesture in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit when the brief does not name one", required: false },
+    setting: {
+      type: "string",
+      description: 'Where they are in their own life ("her small kitchen in Madrid on a weekday morning") \u2014 their casting photo is taken there, and renders use it when the brief leaves the surroundings open. Always fill it: a face with no world comes back looking like a studio headshot.',
+      required: false
+    },
+    guardrails: {
+      type: "string",
+      description: 'Comma-separated things this avatar must never do, e.g. "no competitor logos, no medical claims"',
+      required: false
+    },
+    "source-image": {
+      type: "string",
+      description: "Comma-separated library image ids (up to 6) of photographs of a REAL person to build the likeness from. Requires --likeness-confirmed. Source them with `baker images upload`/`library` first.",
+      required: false
+    },
+    "likeness-confirmed": {
+      type: "boolean",
+      description: "The company's statement that it may use this real person's image in advertising. Required with --source-image. Pass it when the user gave you the photos, or the person is someone the company features in its own marketing (its founder, its team, a customer quoted by name) \u2014 that request is the statement; there is no separate question to ask.",
+      required: false
+    },
+    face: {
+      type: "string",
+      description: "Who picks the face, for an invented avatar: 'ask' (default) blocks on the user through `request_avatar_casting`, 'auto' keeps the one this build casts and asks nobody. Use 'auto' only when there is no one to answer \u2014 a Schedule, a batch, an explicit \"do it yourself\" \u2014 because a person who is there almost always wants this choice.",
+      required: false
+    },
+    output: {
+      type: "string",
+      description: "Output format. Only `json`, which is what this returns anyway \u2014 accepted because `avatars list` and `avatars get` take it, so reaching for it here is the obvious guess.",
+      required: false,
+      default: "json"
+    }
+  }
+});
+var createCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: 'Cast a new avatar (reusable AI presenter). Example: baker avatars create --name "Marta" --subject "woman in her early 40s, shoulder-length dark hair, light olive skin, warm open face" --persona "friendly product expert". Returns while the identity sheet is still building.'
+  },
+  args: {
+    name: { type: "string", description: "Display name", required: false },
+    handle: { type: "string", description: "Mention handle (derived from the name when omitted)", required: false },
+    subject: { type: "string", description: "The person, plainly described \u2014 reused verbatim", required: false },
+    persona: { type: "string", description: "Who they are on camera", required: false },
+    speech: { type: "string", description: "How they speak", required: false },
+    accent: {
+      type: "string",
+      description: "Where their voice is FROM \u2014 name the region, e.g. 'Spanish from Spain, Madrid accent'",
+      required: false
+    },
+    motion: { type: "string", description: "Body language in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit", required: false },
+    setting: { type: "string", description: "Default surroundings", required: false },
+    guardrails: { type: "string", description: "Comma-separated things they must never do", required: false },
+    "source-image": {
+      type: "string",
+      description: "Comma-separated library image ids of a real person (needs --likeness-confirmed)",
+      required: false
+    },
+    "likeness-confirmed": {
+      type: "boolean",
+      description: "The company may use this real person's image in advertising",
+      required: false,
+      default: false
+    },
+    face: {
+      type: "string",
+      description: "Who picks the face of an invented avatar: 'ask' (default, blocks on the user) or 'auto' (asks nobody)",
+      required: false
+    },
+    output: {
+      type: "string",
+      description: "Output format \u2014 `json` only, which is what this returns anyway",
+      required: false,
+      default: "json"
+    }
+  },
+  run: async ({ args }) => {
+    const name = args.name?.trim();
+    if (!name) {
+      failValidation('--name is required, e.g. `baker avatars create --name "Marta" --subject "\u2026"`.');
+    }
+    const profile = buildProfilePatch(args);
+    const subjectDescription = profile.subjectDescription;
+    if (!subjectDescription) {
+      failValidation(
+        "--subject is required: it is the identity every render of this avatar is built from, and it is copied into each prompt word for word.",
+        {
+          action: "describe_the_person",
+          explanation: 'Write one person, plainly: age range, build, hair, skin, face, anything distinctive. No scene, no lighting, no camera, no wardrobe. Good: "woman in her early 40s, shoulder-length dark brown hair, light olive skin, warm open face, slight smile lines". Bad: "confident businesswoman in a sunlit office". If the user described a real person and you have their photos, pass --source-image with --likeness-confirmed instead of inventing the description; if they are named but you have no photos, run `baker avatars research "<name>, <role> at <company>" --create`.'
+        }
+      );
+    }
+    const handle = args.handle?.trim().toLowerCase();
+    if (handle && !AVATAR_HANDLE_PATTERN.test(handle)) {
+      failValidation(
+        `--handle "${handle}" is not usable. Use lowercase letters, numbers and dashes, starting with a letter \u2014 "maria-founder", not "Maria Founder". Leave it off to have one derived from the name.`
+      );
+    }
+    const output = args.output?.trim().toLowerCase();
+    if (output && output !== "json") {
+      failValidation(
+        `\`--output ${output}\` is not a format \`baker avatars create\` produces \u2014 it returns JSON and nothing else. Drop the flag, or pass \`--output json\`. \`baker avatars list\` and \`baker avatars get\` are the ones that also render \`files\` and \`md\`.`
+      );
+    }
+    const faceChoice = parseFaceChoice(args.face);
+    if (faceChoice === null) {
+      failValidation(
+        `--face "${String(args.face)}" is not a mode. Use --face ask to let the user pick the face, or --face auto to keep the one this build casts.`,
+        {
+          action: "pick_a_mode",
+          explanation: "Drop the flag entirely if a person is in the conversation \u2014 that is --face ask, and it is what they almost always want. Pass --face auto only when nobody is there to answer: a Schedule, a batch run, or the user telling you to do it without them."
+        }
+      );
+    }
+    const sourceImageIds = parseImageIds(args["source-image"]);
+    const likenessConfirmed = Boolean(args["likeness-confirmed"]);
+    if (sourceImageIds && !likenessConfirmed) {
+      failValidation(
+        "Building an avatar from photographs of a real person needs --likeness-confirmed: the company has to state that it may use that person's image in its advertising.",
+        {
+          action: "confirm_the_likeness",
+          explanation: 'Photos the user handed you, or of someone the company features in its own marketing (its founder, its team, a customer it quotes by name), come with that statement: re-run the same command with --likeness-confirmed. If the person is named in the copy and you have no photos, use `baker avatars research "<name>, <role> at <company>" --create` instead. Only if the user said they may NOT use this person\'s image, drop --source-image and cast an invented presenter from --subject \u2014 do not abandon the wider job over it.'
+        }
+      );
+    }
+    try {
+      const body = {
+        name,
+        ...handle ? { handle } : {},
+        profile: { ...profile, subjectDescription },
+        ...sourceImageIds ? { sourceImageIds, likenessConfirmed: true } : {},
+        ...chatIdFromEnv() ? { chatId: chatIdFromEnv() } : {},
+        // Sent so the backend can hold the sheet until the chosen portrait exists —
+        // otherwise it fuses one from a face nobody picked and pays for it twice.
+        faceChoice
+      };
+      const data = await writeAvatars("/api/avatars", body);
+      writeJson({ ok: true, data, hints: creationHints({ ...data, faceChoice }, body.profile) });
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+export {
+  createCommand
+};
+//# sourceMappingURL=create-7IFYLX7P.js.map

package/dist/create-7IFYLX7P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/avatars/create.ts"],"sourcesContent":["import { AVATAR_HANDLE_PATTERN, type AvatarsCreateRequest, type AvatarsCreateResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { chatIdFromEnv, creationHints, parseFaceChoice } from \"./casting.ts\";\nimport { failAvatarApi, failValidation } from \"./failures.ts\";\nimport { buildProfilePatch } from \"./profile.ts\";\nimport { writeAvatars } from \"./transport.ts\";\n\nfunction parseImageIds(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const ids = value\n    .split(\",\")\n    .map((id) => id.trim())\n    .filter((id) => id.length > 0);\n  return ids.length > 0 ? [...new Set(ids)] : undefined;\n}\n\nregisterSchema({\n  command: \"avatars.create\",\n  description:\n    'Cast a new avatar — a reusable AI presenter this company can put in images and video. Start here: `baker avatars create --name \"Marta\" --subject \"woman in her early 40s, shoulder-length dark hair, warm brown eyes, light olive skin\"`. --subject is the identity: describe ONE person plainly (age, build, hair, skin, face) with no scene, no lighting and no wardrobe, because it is copied word for word into every prompt that renders them. Two kinds: invented from your description (default), or built from photographs of a real person (--source-image with --likeness-confirmed, which is the company stating it may use that person\\'s image in advertising). For a real person the copy NAMES — a testimonial author, the founder, a team member — use `baker avatars research \"<name>, <role> at <company>\" --create` instead: it finds their photos and builds the avatar itself. Returns immediately with status `generating` — the identity sheet is a ~30s render that settles in the background.',\n  args: {\n    name: { type: \"string\", description: 'Display name, e.g. \"Marta\"', required: true },\n    handle: {\n      type: \"string\",\n      description: 'Mention handle (lowercase, dashes), e.g. \"marta\". Derived from the name when omitted.',\n      required: false,\n    },\n    subject: {\n      type: \"string\",\n      description:\n        \"The identity, reused verbatim in every render: one person, plainly described (age, build, hair, skin, face). No scene, no lighting, no camera, no wardrobe — those belong in the render prompt or in --wardrobe/--setting.\",\n      required: true,\n    },\n    persona: { type: \"string\", description: \"Who they are on camera — role, attitude, energy\", required: false },\n    speech: { type: \"string\", description: \"How they speak — pace, register, verbal habits\", required: false },\n    accent: {\n      type: \"string\",\n      description:\n        \"Where their VOICE is from, as a place: 'Spanish from Spain, Madrid accent', 'Mexican Spanish', 'British English, London'. Name the region — an adjective like 'clear Spanish accent' is read by the video model as NO accent, and the clip comes out sounding like nowhere. Default to the language the USER is writing to you in, always: they are describing an ad for their own market, and an avatar that answers them in another language is unusable however good it looks. Never take this from how the person LOOKS — 'aspecto europeo', 'Nordic', 'Mediterranean' describe a face and belong in --subject. Read literally, that mistake shipped an ad for a Spanish client with --accent \\\"German\\\", and the clip came back spoken in German.\",\n      required: false,\n    },\n    motion: { type: \"string\", description: \"Body language and gesture in video\", required: false },\n    wardrobe: { type: \"string\", description: \"Default outfit when the brief does not name one\", required: false },\n    setting: {\n      type: \"string\",\n      description:\n        'Where they are in their own life (\"her small kitchen in Madrid on a weekday morning\") — their casting photo is taken there, and renders use it when the brief leaves the surroundings open. Always fill it: a face with no world comes back looking like a studio headshot.',\n      required: false,\n    },\n    guardrails: {\n      type: \"string\",\n      description: 'Comma-separated things this avatar must never do, e.g. \"no competitor logos, no medical claims\"',\n      required: false,\n    },\n    \"source-image\": {\n      type: \"string\",\n      description:\n        \"Comma-separated library image ids (up to 6) of photographs of a REAL person to build the likeness from. Requires --likeness-confirmed. Source them with `baker images upload`/`library` first.\",\n      required: false,\n    },\n    \"likeness-confirmed\": {\n      type: \"boolean\",\n      description:\n        \"The company's statement that it may use this real person's image in advertising. Required with --source-image. Pass it when the user gave you the photos, or the person is someone the company features in its own marketing (its founder, its team, a customer quoted by name) — that request is the statement; there is no separate question to ask.\",\n      required: false,\n    },\n    face: {\n      type: \"string\",\n      description:\n        \"Who picks the face, for an invented avatar: 'ask' (default) blocks on the user through `request_avatar_casting`, 'auto' keeps the one this build casts and asks nobody. Use 'auto' only when there is no one to answer — a Schedule, a batch, an explicit \\\"do it yourself\\\" — because a person who is there almost always wants this choice.\",\n      required: false,\n    },\n    output: {\n      type: \"string\",\n      description:\n        \"Output format. Only `json`, which is what this returns anyway — accepted because `avatars list` and `avatars get` take it, so reaching for it here is the obvious guess.\",\n      required: false,\n      default: \"json\",\n    },\n  },\n});\n\nexport const createCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description:\n      'Cast a new avatar (reusable AI presenter). Example: baker avatars create --name \"Marta\" --subject \"woman in her early 40s, shoulder-length dark hair, light olive skin, warm open face\" --persona \"friendly product expert\". Returns while the identity sheet is still building.',\n  },\n  args: {\n    name: { type: \"string\", description: \"Display name\", required: false },\n    handle: { type: \"string\", description: \"Mention handle (derived from the name when omitted)\", required: false },\n    subject: { type: \"string\", description: \"The person, plainly described — reused verbatim\", required: false },\n    persona: { type: \"string\", description: \"Who they are on camera\", required: false },\n    speech: { type: \"string\", description: \"How they speak\", required: false },\n    accent: {\n      type: \"string\",\n      description: \"Where their voice is FROM — name the region, e.g. 'Spanish from Spain, Madrid accent'\",\n      required: false,\n    },\n    motion: { type: \"string\", description: \"Body language in video\", required: false },\n    wardrobe: { type: \"string\", description: \"Default outfit\", required: false },\n    setting: { type: \"string\", description: \"Default surroundings\", required: false },\n    guardrails: { type: \"string\", description: \"Comma-separated things they must never do\", required: false },\n    \"source-image\": {\n      type: \"string\",\n      description: \"Comma-separated library image ids of a real person (needs --likeness-confirmed)\",\n      required: false,\n    },\n    \"likeness-confirmed\": {\n      type: \"boolean\",\n      description: \"The company may use this real person's image in advertising\",\n      required: false,\n      default: false,\n    },\n    face: {\n      type: \"string\",\n      description:\n        \"Who picks the face of an invented avatar: 'ask' (default, blocks on the user) or 'auto' (asks nobody)\",\n      required: false,\n    },\n    output: {\n      type: \"string\",\n      description: \"Output format — `json` only, which is what this returns anyway\",\n      required: false,\n      default: \"json\",\n    },\n  },\n  run: async ({ args }) => {\n    const name = (args.name as string | undefined)?.trim();\n    if (!name) {\n      failValidation('--name is required, e.g. `baker avatars create --name \"Marta\" --subject \"…\"`.');\n    }\n\n    const profile = buildProfilePatch(args);\n    const subjectDescription = profile.subjectDescription;\n    if (!subjectDescription) {\n      failValidation(\n        \"--subject is required: it is the identity every render of this avatar is built from, and it is copied into each prompt word for word.\",\n        {\n          action: \"describe_the_person\",\n          explanation:\n            'Write one person, plainly: age range, build, hair, skin, face, anything distinctive. No scene, no lighting, no camera, no wardrobe. Good: \"woman in her early 40s, shoulder-length dark brown hair, light olive skin, warm open face, slight smile lines\". Bad: \"confident businesswoman in a sunlit office\". If the user described a real person and you have their photos, pass --source-image with --likeness-confirmed instead of inventing the description; if they are named but you have no photos, run `baker avatars research \"<name>, <role> at <company>\" --create`.',\n        },\n      );\n    }\n\n    const handle = (args.handle as string | undefined)?.trim().toLowerCase();\n    if (handle && !AVATAR_HANDLE_PATTERN.test(handle)) {\n      failValidation(\n        `--handle \"${handle}\" is not usable. Use lowercase letters, numbers and dashes, starting with a letter — \"maria-founder\", not \"Maria Founder\". Leave it off to have one derived from the name.`,\n      );\n    }\n\n    // Accepted rather than refused, because refusing it cost a whole create: the command\n    // was rejected for this flag alone, the agent retried without it, and the retry landed\n    // while the casting for the first attempt was still pending — so the avatar that DID\n    // get made never got a face picker. `create` has one shape of output; saying so is\n    // cheaper than being right about it.\n    const output = (args.output as string | undefined)?.trim().toLowerCase();\n    if (output && output !== \"json\") {\n      failValidation(\n        `\\`--output ${output}\\` is not a format \\`baker avatars create\\` produces — it returns JSON and nothing else. Drop the flag, or pass \\`--output json\\`. \\`baker avatars list\\` and \\`baker avatars get\\` are the ones that also render \\`files\\` and \\`md\\`.`,\n      );\n    }\n\n    const faceChoice = parseFaceChoice(args.face as string | undefined);\n    if (faceChoice === null) {\n      failValidation(\n        `--face \"${String(args.face)}\" is not a mode. Use --face ask to let the user pick the face, or --face auto to keep the one this build casts.`,\n        {\n          action: \"pick_a_mode\",\n          explanation:\n            \"Drop the flag entirely if a person is in the conversation — that is --face ask, and it is what they almost always want. Pass --face auto only when nobody is there to answer: a Schedule, a batch run, or the user telling you to do it without them.\",\n        },\n      );\n    }\n\n    const sourceImageIds = parseImageIds(args[\"source-image\"]);\n    const likenessConfirmed = Boolean(args[\"likeness-confirmed\"]);\n    if (sourceImageIds && !likenessConfirmed) {\n      failValidation(\n        \"Building an avatar from photographs of a real person needs --likeness-confirmed: the company has to state that it may use that person's image in its advertising.\",\n        {\n          action: \"confirm_the_likeness\",\n          explanation:\n            'Photos the user handed you, or of someone the company features in its own marketing (its founder, its team, a customer it quotes by name), come with that statement: re-run the same command with --likeness-confirmed. If the person is named in the copy and you have no photos, use `baker avatars research \"<name>, <role> at <company>\" --create` instead. Only if the user said they may NOT use this person\\'s image, drop --source-image and cast an invented presenter from --subject — do not abandon the wider job over it.',\n        },\n      );\n    }\n\n    try {\n      const body: AvatarsCreateRequest = {\n        name,\n        ...(handle ? { handle } : {}),\n        profile: { ...profile, subjectDescription },\n        ...(sourceImageIds ? { sourceImageIds, likenessConfirmed: true } : {}),\n        ...(chatIdFromEnv() ? { chatId: chatIdFromEnv() } : {}),\n        // Sent so the backend can hold the sheet until the chosen portrait exists —\n        // otherwise it fuses one from a face nobody picked and pays for it twice.\n        faceChoice,\n      };\n\n      const data = await writeAvatars<AvatarsCreateResponse>(\"/api/avatars\", body);\n      writeJson({ ok: true, data, hints: creationHints({ ...data, faceChoice }, body.profile) });\n    } catch (err) {\n      failAvatarApi(err, handle);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/create-FOHIQC3E.js

@@ -0,0 +1,62 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-UDIEKCIR.js";
+import "./chunk-PC3FJEZH.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/tags/create.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.tags.create",
+  description: "Create a company custom action tag, minting a new slug usable with --tags. The name is slugified (lowercased, spaces\u2192hyphens). Use when no existing tag fits the work.",
+  args: {
+    slug: { type: "string", description: "Tag name/slug (e.g. pmax, retargeting)", required: true },
+    description: { type: "string", description: "What this tag means", required: false }
+  }
+});
+var tagsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: 'Create a custom action tag. Example: baker actions tags create --slug pmax --description "Performance Max work"'
+  },
+  args: {
+    slug: { type: "string", description: "Tag name/slug", required: false },
+    description: { type: "string", description: "Description", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const slug = args.slug;
+      if (!slug || slug.trim().length === 0) {
+        failValidation("--slug is required.");
+      }
+      const response = await apiPost("/api/actions/tags/create", {
+        name: slug,
+        description: args.description
+      });
+      writeOk(response.data);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  tagsCreateCommand
+};
+//# sourceMappingURL=create-FOHIQC3E.js.map

package/dist/create-FOHIQC3E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/actions/tags/create.ts"],"sourcesContent":["import type { ActionsTagsCreateResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { failApi, failValidation, writeOk } from \"../shared.ts\";\n\nregisterSchema({\n  command: \"actions.tags.create\",\n  description:\n    \"Create a company custom action tag, minting a new slug usable with --tags. The name is slugified (lowercased, spaces→hyphens). Use when no existing tag fits the work.\",\n  args: {\n    slug: { type: \"string\", description: \"Tag name/slug (e.g. pmax, retargeting)\", required: true },\n    description: { type: \"string\", description: \"What this tag means\", required: false },\n  },\n});\n\nexport const tagsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description:\n      'Create a custom action tag. Example: baker actions tags create --slug pmax --description \"Performance Max work\"',\n  },\n  args: {\n    slug: { type: \"string\", description: \"Tag name/slug\", required: false },\n    description: { type: \"string\", description: \"Description\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const slug = args.slug as string | undefined;\n      if (!slug || slug.trim().length === 0) {\n        failValidation(\"--slug is required.\");\n      }\n      const response = await apiPost<ActionsTagsCreateResponse>(\"/api/actions/tags/create\", {\n        name: slug,\n        description: args.description,\n      });\n      writeOk(response.data);\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAK9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,KAAK;AAAA,IAC9F,aAAa,EAAE,MAAM,UAAU,aAAa,uBAAuB,UAAU,MAAM;AAAA,EACrF;AACF,CAAC;AAEM,IAAM,oBAAoB,cAAc;AAAA,EAC7C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,UAAU,aAAa,iBAAiB,UAAU,MAAM;AAAA,IACtE,aAAa,EAAE,MAAM,UAAU,aAAa,eAAe,UAAU,MAAM;AAAA,EAC7E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAO,KAAK;AAClB,UAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,WAAW,GAAG;AACrC,uBAAe,qBAAqB;AAAA,MACtC;AACA,YAAM,WAAW,MAAM,QAAmC,4BAA4B;AAAA,QACpF,MAAM;AAAA,QACN,aAAa,KAAK;AAAA,MACpB,CAAC;AACD,cAAQ,SAAS,IAAI;AAAA,IACvB,SAAS,KAAK;AACZ,cAAQ,GAAG;AAAA,IACb;AAAA,EACF;AACF,CAAC;","names":[]}