@koda-sl/baker-cli 0.231.0 → 0.232.1

package/dist/cli.js

@@ -565,498 +565,6 @@ function listSchemas() {
   return [...registry.keys()];
 }
 
-// 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 `temp_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-}
-function isTempId(id) {
-  return id.startsWith("temp_");
-}
-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)];
-}
-function fold(text2) {
-  return text2.normalize("NFD").replace(/[̀-ͯ]/g, "");
-}
-var SCHEDULE_SIGNALS = [
-  /\brecurr(?:ing|ence)\b/i,
-  /\bcadence\b/i,
-  /\bcron\b/i,
-  /\bschedule[ds]?\b/i,
-  /\b(?:daily|weekly|monthly|quarterly|annual(?:ly)?|biweekly|nightly)\b/i,
-  /\bevery\s+(?:day|week|month|quarter|year|morning|monday|tuesday|wednesday|thursday|friday|saturday|sunday|\d)/i,
-  /\beach\s+(?:day|week|month|monday|tuesday|wednesday|thursday|friday|saturday|sunday)\b/i,
-  /\bremind(?:er|s)?\b/i,
-  /\brun\s+at\b/i
-];
-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" : ""}.`
-  );
-}
-function looksScheduled(name, description) {
-  const haystack = fold(`${name}
-${description}`);
-  return SCHEDULE_SIGNALS.some((re2) => re2.test(haystack));
-}
-var CAMPAIGN_ENTITY = String.raw`(?:campaigns?|campanas?|ad\s*sets?|adsets?|ad\s*groups?|adgroups?|ads?|anuncios?|conjuntos?\s+de\s+anuncios|grupos?\s+de\s+anuncios)`;
-var LIFECYCLE_VERB = "(?:pause|unpause|enable|disable|launch|restructure|duplicate|clone|rebuild|prune|reweight|split|consolidate|pausar|pausa|activar|podar|poda|reponderar|duplicar|reestructurar|consolidar)";
-var BUDGET_VERB = "(?:cap|raise|lower|increase|decrease|adjust|change|set|update|reallocate|shift|limitar|subir|bajar|ajustar|aplicar|reasignar)";
-var re = (...parts) => new RegExp(parts.join(""), "i");
-var SURFACE_RULES = [
-  {
-    surface: "ask-user",
-    signals: [
-      /\bproduction\s+(?:domain|url|site|hostname)\b/i,
-      /\b(?:confirm|check|verify|confirmar|verificar)\s+(?:with|w\/|con)\s+(?:the\s+|el\s+|la\s+)?(?:client|user|customer|team|cliente|usuario|equipo)\b/i,
-      /\bmissing\s+(?:the\s+)?(?:value|values|id|ids|url|budget|domain|credentials?|account\s+id|measurement\s+id)\b/i,
-      /\b(?:ask|get)\s+(?:the\s+)?(?:client|user)\s+for\b/i,
-      /\b(?:pedir|solicitar)\s+(?:al\s+)?cliente\b/i
-    ],
-    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."
-  },
-  {
-    surface: "analysis",
-    nameOnly: true,
-    signals: [
-      /^\s*(?:re-?)?(?:investigat|analy[sz]|audit|review|document|assess|evaluat|research|map|inventor|examin|diagnos|verif|validat|benchmark)\w*\b/i,
-      /^\s*(?:auditar|auditoria|investigar|investigacion|revisar|revision|analizar|analisis|documentar|evaluar|evaluacion|diagnosticar|diagnostico|mapear|inventariar|verificar|verificacion|comprobar|estudiar|estudio)\b/i
-    ],
-    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`)."
-  },
-  {
-    surface: "ads-write",
-    // "Approve X" is a human decision, not a staged write — and the budget
-    // signals are broad enough to swallow it otherwise. Name-anchored so a
-    // description recalling an earlier approval doesn't veto real work.
-    exceptName: [/^\s*(?:approve|approval|sign[-\s]?off|aprobar|aprobacion)\b/i],
-    // Bare `keywords` is the work when it's the subject of the Task, but plain
-    // context when a description happens to discuss search terms.
-    nameOnlySignals: [/\b(?:keywords?|palabras\s+clave)\b/i],
-    signals: [
-      // Targeting.
-      /\b(?:geo|location|geographic|geografic\w*)[\s-]*(?:targeting|target|segmentacion)\b/i,
-      /\bsegmentacion\s+(?:geografica|por\s+ubicacion)\b/i,
-      /\bpresence[-\s_]?(?:only|or[-\s_]?interest)\b/i,
-      /\b(?:ad\s*schedul\w*|dayparting|calendario\s+de\s+anuncios)\b/i,
-      // Extensions / assets.
-      /\b(?:callouts?|sitelinks?|site\s*links?|structured\s+snippets?|price\s+extensions?|lead\s+form\s+extensions?|extensiones|asset\s+groups?)\b/i,
-      // Ad copy. Compound forms only — bare `headline` and `copy` belong to
-      // `landing`, and an RSA headline has to say so.
-      /\b(?:rsas?|responsive\s+search\s+ads?|ad\s+copy|copy\s+de\s+(?:los\s+)?anuncios)\b/i,
-      /\b(?:headline|titular|description)\s+(?:pool|set|slots?)\b/i,
-      /\bdisplay\s+paths?\b|\brutas?\s+visibles?\b/i,
-      // Keywords. `negatives` is bare in English because in this product's
-      // vocabulary the noun is always negative keywords; the Spanish side is
-      // feminine-only, because "resultados negativos" is a real phrase.
-      /\bmatch\s+types?\b|\bconcordancias?\b/i,
-      /\bnegatives?\b/i,
-      /\b(?:palabras\s+clave\s+)?negativas\b/i,
-      /\bkeyword\s+lists?\b|\blistas?\s+de\s+palabras\s+clave\b/i,
-      // Audiences. `LAL` is the operators' own shorthand for a lookalike and
-      // has no other reading in this corpus.
-      /\b(?:in-?market|affinity|audience\s+signals?|senales?\s+de\s+audiencia)\b/i,
-      /\b(?:audiencias?|lal)\b/i,
-      /\blistas?\s+de\s+(?:exclusion|remarketing)\b|\bexclusion\s+lists?\b/i,
-      // URLs.
-      /\btracking\s+(?:url\s+)?templates?\b|\bfinal\s+urls?\b|\bfinal\s+url\s+suffix\b/i,
-      // Bidding.
-      /\bbid\s+(?:adjustments?|modifiers?|strateg\w*)\b|\bajustes?\s+de\s+puja\b/i,
-      /\b(?:tcpa|troas|target\s+cpa|target\s+roas)\b/i,
-      // Lifecycle. Bare `campaign` is deliberately NOT a signal — it appears
-      // everywhere and would strip tag-manager and landing of correct
-      // routings, so every campaign-shaped rule needs a verb or a specific
-      // setting noun next to it.
-      // Bounded, and never across the name/description boundary. `ads` is an
-      // ordinary word in this domain, so an unbounded gap lets a verb in the
-      // name pair with a passing mention in the description — and since
-      // ads-write is evaluated first, that spurious match outranks the surface
-      // which should have answered.
-      re(String.raw`\b`, LIFECYCLE_VERB, String.raw`\b[^\n]{0,40}\b`, CAMPAIGN_ENTITY, String.raw`\b`),
-      // Budget. Two complementary shapes — verb before, quantity after — so a
-      // change stated either way lands, guarded by the `exceptName` veto above.
-      /\b(?:daily|campaign|lifetime|ad\s*set|minimum|min|competitor)\s+budgets?\b/i,
-      /\bpresupuestos?\b/i,
-      re(String.raw`\b`, BUDGET_VERB, String.raw`\b[\s\S]{0,24}\bbudgets?\b`),
-      /\bbudgets?\b[\s\S]{0,24}\b(?:at|to|cap|down|up|\d|%|€|\$)/i,
-      /\bnegative\s+keywords?\b/i,
-      /\b(?:lookalike|custom)\s+audience\b/i,
-      /\bswap\s+(?:the\s+)?creative\b/i
-    ],
-    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."
-  },
-  {
-    surface: "tag-manager",
-    signals: [
-      /\bgtm\b/i,
-      /\btag\s*manager\b/i,
-      /\bdata\s*layer\b/i,
-      /\bfiring\s+trigger\b/i,
-      /\bbuilt-?in\s+variables?\b/i,
-      /\bconsent\s+(?:mode|settings?|state)\b/i,
-      /\bga4\s+(?:config|configuration|event)\b/i,
-      /\bcontainer\s+(?:tag|trigger|variable)s?\b/i,
-      /\b(?:conversion|form|submit|submission|click|purchase|lead|custom)\s+event\b/i,
-      /\btrack\w*\b[\s\S]*\bevent\b/i,
-      /\beventos?\s+de\s+(?:formulario|conversion|clic|compra)\b/i,
-      /\bconsentimiento\b/i,
-      /\bmedicion\b/i
-    ],
-    except: [/\bserver-?\s?side\b/i, /\bsgtm\b/i, /\bhosting\b/i],
-    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."
-  },
-  {
-    surface: "site-tags",
-    signals: [
-      /\bpixel\b/i,
-      /\binsight\s+tag\b/i,
-      /\bclarity\b/i,
-      /\bhotjar\b/i,
-      /\bgtm\s+snippet\b/i,
-      /\bcapi\b/i,
-      /\b(?:install|add|remove|swap|instalar|colocar)\b[\s\S]*\b(?:snippet|script|tag)\b/i
-    ],
-    // Two vetoes. A structured snippet is a Google Ads extension, not a script
-    // on the page — `ads-write` claims it above, and this stops both rules
-    // being able to answer. Server-side delivery is infrastructure nobody here
-    // can provision, the same call `tag-manager` already makes for sGTM.
-    except: [/\bstructured\s+snippets?\b/i, /\bserver-?\s?side\b/i, /\bhosting\b/i],
-    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."
-  },
-  {
-    surface: "landing",
-    nameOnlySignals: [/\b(?:landing\s+pages?|landings?|hero|headline|above\s+the\s+fold|pagina)\b/i],
-    signals: [/\b(?:rewrite|tighten|restyle)\b[\s\S]*\b(?:copy|page|section)\b/i],
-    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."
-  },
-  {
-    surface: "flow",
-    signals: [/\b(?:form|flow)\s+(?:step|steps|branching|logic|redirect|behaviou?r)\b/i, /\bthank\s*you\s+redirect\b/i],
-    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 FAN_OUT_NUDGE_THRESHOLD = 2;
-var FAN_OUT_THRESHOLD = 3;
-var SCHEDULED_HINT = 'This reads as recurring/scheduled work. If it should run on a cadence or a future date, create a Scheduled Action instead \u2014 baker scheduled-actions create --cron "0 9 * * MON" (or --run-at; guide: `__tooling__/docs/tools/baker/scheduled-actions.md`). Do NOT capture "set up a scheduled action" as a Work Action.';
-function looksExecutable(name, description) {
-  const foldedName = fold(name);
-  const full = `${foldedName}
-${fold(description)}`;
-  for (const rule of SURFACE_RULES) {
-    const haystack = rule.nameOnly ? foldedName : full;
-    if (rule.except?.some((re2) => re2.test(full))) {
-      continue;
-    }
-    if (rule.exceptName?.some((re2) => re2.test(foldedName))) {
-      continue;
-    }
-    if (rule.signals.some((re2) => re2.test(haystack))) {
-      return { surface: rule.surface, hint: rule.hint };
-    }
-    if (rule.nameOnlySignals?.some((re2) => re2.test(foldedName))) {
-      return { surface: rule.surface, hint: rule.hint };
-    }
-  }
-  return null;
-}
-function buildCreateHints({
-  name,
-  description,
-  tempId,
-  tags,
-  prioritySet,
-  draftCreateCount
-}) {
-  const hints = [];
-  const advisory = advisoryHint(name, description);
-  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 advisoryHint(name, description) {
-  if (looksScheduled(name, description)) {
-    return { kind: "scheduled", hint: SCHEDULED_HINT };
-  }
-  const executable = looksExecutable(name, description);
-  return executable ? { kind: "executable", ...executable } : 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 / --q).`
-  ];
-}
-
-// src/commands/actions/skillCatalog.ts
-import { existsSync, readdirSync, readFileSync } from "fs";
-import { dirname, join } from "path";
-var DESCRIPTION_MAX = 600;
-var SKILLS_SUBPATH = join(".claude", "skills");
-var EXCLUDED_SKILLS = /* @__PURE__ */ new Set(["actions"]);
-function stripQuotes(value) {
-  const trimmed = value.trim();
-  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
-    return trimmed.slice(1, -1).replace(/\\"/g, '"').replace(/\\n/g, "\n");
-  }
-  if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
-    return trimmed.slice(1, -1).replace(/''/g, "'");
-  }
-  return trimmed;
-}
-function extractFrontmatterLines(md) {
-  if (!md.startsWith("---")) return null;
-  const end = md.indexOf("\n---", 3);
-  if (end === -1) return null;
-  return md.slice(md.indexOf("\n", 3) + 1, end).split("\n");
-}
-var BLOCK_SCALAR = /^([|>])[+-]?$/;
-function collectBlockLines(lines, start) {
-  const collected = [];
-  for (let i = start; i < lines.length; i++) {
-    const line = lines[i] ?? "";
-    if (line.trim() === "") {
-      collected.push("");
-    } else if (/^\s/.test(line)) {
-      collected.push(line.trim());
-    } else {
-      break;
-    }
-  }
-  while (collected.length > 0 && collected.at(-1) === "") collected.pop();
-  return collected;
-}
-function foldLines(collected) {
-  const paragraphs = [];
-  let buffer = [];
-  for (const line of collected) {
-    if (line === "") {
-      if (buffer.length > 0) paragraphs.push(buffer.join(" "));
-      buffer = [];
-    } else {
-      buffer.push(line);
-    }
-  }
-  if (buffer.length > 0) paragraphs.push(buffer.join(" "));
-  return paragraphs.join("\n");
-}
-function readBlockScalar(lines, start, style) {
-  const collected = collectBlockLines(lines, start);
-  return style === "|" ? collected.join("\n") : foldLines(collected);
-}
-function readField(lines, field) {
-  for (let i = 0; i < lines.length; i++) {
-    const match = (lines[i] ?? "").match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
-    if (!match || match[1] !== field) continue;
-    const inline = (match[2] ?? "").trim();
-    const scalar = inline.match(BLOCK_SCALAR);
-    if (scalar) {
-      return readBlockScalar(lines, i + 1, scalar[1]);
-    }
-    return stripQuotes(inline);
-  }
-  return null;
-}
-function parseSkillFrontmatter(md) {
-  const lines = extractFrontmatterLines(md);
-  if (!lines) return null;
-  const name = readField(lines, "name");
-  const description = readField(lines, "description");
-  if (!name || !description) return null;
-  const trimmed = description.length > DESCRIPTION_MAX ? `${description.slice(0, DESCRIPTION_MAX)}\u2026` : description;
-  return { name, description: trimmed };
-}
-function findSkillsDir(startDir) {
-  let dir = startDir;
-  for (; ; ) {
-    const candidate = join(dir, SKILLS_SUBPATH);
-    if (existsSync(candidate)) return candidate;
-    const parent = dirname(dir);
-    if (parent === dir) return null;
-    dir = parent;
-  }
-}
-function readSkillCatalog(startDir) {
-  const skillsDir = findSkillsDir(startDir);
-  if (!skillsDir) return [];
-  const entries = [];
-  for (const dirent of readdirSync(skillsDir, { withFileTypes: true })) {
-    if (!dirent.isDirectory() || EXCLUDED_SKILLS.has(dirent.name)) continue;
-    const skillFile = join(skillsDir, dirent.name, "SKILL.md");
-    if (!existsSync(skillFile)) continue;
-    try {
-      const parsed = parseSkillFrontmatter(readFileSync(skillFile, "utf8"));
-      if (parsed) entries.push(parsed);
-    } catch {
-    }
-  }
-  return entries.sort((a, b) => a.name.localeCompare(b.name));
-}
-
-// src/commands/actions/claim.ts
-registerSchema({
-  command: "actions.claim",
-  description: "Claim an action for the current chat (live \u2014 visible to other chats immediately). Claim only what you're actively working on now: it's required before `complete`, but NOT for `update` or `discard` (those stage without a claim). Returns action details plus a fast-model recommendation of which skills to load for the work (`recommendedSkills`) and a routing hint: load every skill that owns part of the work and the tool doc for each baker CLI family you'll use.",
-  args: {
-    id: { type: "string", description: "Action ID", required: true }
-  }
-});
-async function recommendSkills(actionId) {
-  const skills = readSkillCatalog(process.cwd());
-  if (skills.length === 0) return [];
-  const response = await apiPost("/api/actions/recommend-skills", {
-    actionId,
-    skills
-  });
-  return response.data.recommendations;
-}
-var ROUTING_HINT = "Actions often span several surfaces (a landing page plus a Google Ads change, a sheet pull plus an audience upload). Before starting, load EVERY skill that owns part of the work and read the tool doc (__tooling__/docs/tools/baker/<family>.md) for each baker CLI family you'll use. If the action references source material living in a connected tool (an email attachment, a call, a CRM record, a spreadsheet), reach for that tool too. If it describes recurring or future-dated work, it belongs on a schedule \u2014 see __tooling__/docs/tools/baker/scheduled-actions.md.";
-function buildHints(recommendations) {
-  if (recommendations.length === 0) {
-    return ["Review the action name, description, and tags above.", ROUTING_HINT];
-  }
-  return [
-    "Recommended skills for this action (load the ones you'll use):",
-    ...recommendations.map((r) => `  /${r.name} \u2014 ${r.reason}`),
-    "Suggestions come from the action's name/description/tags only \u2014 the work may need more.",
-    ROUTING_HINT
-  ];
-}
-var claimCommand = defineCommand({
-  meta: {
-    name: "claim",
-    description: "Claim an action so other chats see you're working on it. Required before `complete` (update and discard don't need a claim). Example: baker actions claim <action-id>"
-  },
-  args: {
-    id: { type: "positional", description: "Action ID", required: false },
-    "action-id": { type: "string", description: "Action ID", required: false }
-  },
-  run: async ({ args }) => {
-    try {
-      const id = args.id || args["action-id"];
-      if (!id) {
-        failValidation("Action ID is required.");
-      }
-      validateConvexId(id);
-      const chatId = requireChatId();
-      const response = await apiPost("/api/actions/claim", {
-        actionId: id,
-        chatId
-      });
-      let recommendedSkills = [];
-      try {
-        recommendedSkills = await recommendSkills(id);
-      } catch {
-      }
-      const data = response.data ? { ...response.data, recommendedSkills } : response.data;
-      writeJson({ ok: response.ok, data, hints: buildHints(recommendedSkills) });
-    } catch (err) {
-      failApi(err);
-    }
-  }
-});
-
 // ../api/src/actions.ts
 import { z } from "zod";
 var actionStatusSchema = z.enum(["pending", "in_progress", "completed", "discarded"]);
@@ -1199,9 +707,13 @@ function okResponse(data) {
 function okOnlySchema() {
   return z.object({ ok: z.literal(true) });
 }
+var ACTION_TEMP_ID_PREFIX = "temp_";
+var actionTempIdSchema = z.string().refine((value) => value.startsWith(ACTION_TEMP_ID_PREFIX) && value.length > ACTION_TEMP_ID_PREFIX.length, {
+  message: "tempId must start with `temp_` and have something after it (e.g. temp_hero_copy). Omit --temp-id to get a generated one."
+});
 var actionsCreateRequestSchema = z.object({
   chatId: z.string(),
-  tempId: z.string(),
+  tempId: actionTempIdSchema,
   name: z.string().min(1),
   description: z.string(),
   tags: z.array(z.string()).optional(),
@@ -6665,6 +6177,498 @@ var videosIngestResponseSchema = z21.object({
 var videosDeleteRequestSchema = z21.object({ id: z21.string().min(1, "Missing video ID") });
 var videosDeleteResponseSchema = z21.object({ ok: z21.literal(true) });
 
+// 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)];
+}
+function fold(text2) {
+  return text2.normalize("NFD").replace(/[̀-ͯ]/g, "");
+}
+var SCHEDULE_SIGNALS = [
+  /\brecurr(?:ing|ence)\b/i,
+  /\bcadence\b/i,
+  /\bcron\b/i,
+  /\bschedule[ds]?\b/i,
+  /\b(?:daily|weekly|monthly|quarterly|annual(?:ly)?|biweekly|nightly)\b/i,
+  /\bevery\s+(?:day|week|month|quarter|year|morning|monday|tuesday|wednesday|thursday|friday|saturday|sunday|\d)/i,
+  /\beach\s+(?:day|week|month|monday|tuesday|wednesday|thursday|friday|saturday|sunday)\b/i,
+  /\bremind(?:er|s)?\b/i,
+  /\brun\s+at\b/i
+];
+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" : ""}.`
+  );
+}
+function looksScheduled(name, description) {
+  const haystack = fold(`${name}
+${description}`);
+  return SCHEDULE_SIGNALS.some((re2) => re2.test(haystack));
+}
+var CAMPAIGN_ENTITY = String.raw`(?:campaigns?|campanas?|ad\s*sets?|adsets?|ad\s*groups?|adgroups?|ads?|anuncios?|conjuntos?\s+de\s+anuncios|grupos?\s+de\s+anuncios)`;
+var LIFECYCLE_VERB = "(?:pause|unpause|enable|disable|launch|restructure|duplicate|clone|rebuild|prune|reweight|split|consolidate|pausar|pausa|activar|podar|poda|reponderar|duplicar|reestructurar|consolidar)";
+var BUDGET_VERB = "(?:cap|raise|lower|increase|decrease|adjust|change|set|update|reallocate|shift|limitar|subir|bajar|ajustar|aplicar|reasignar)";
+var re = (...parts) => new RegExp(parts.join(""), "i");
+var SURFACE_RULES = [
+  {
+    surface: "ask-user",
+    signals: [
+      /\bproduction\s+(?:domain|url|site|hostname)\b/i,
+      /\b(?:confirm|check|verify|confirmar|verificar)\s+(?:with|w\/|con)\s+(?:the\s+|el\s+|la\s+)?(?:client|user|customer|team|cliente|usuario|equipo)\b/i,
+      /\bmissing\s+(?:the\s+)?(?:value|values|id|ids|url|budget|domain|credentials?|account\s+id|measurement\s+id)\b/i,
+      /\b(?:ask|get)\s+(?:the\s+)?(?:client|user)\s+for\b/i,
+      /\b(?:pedir|solicitar)\s+(?:al\s+)?cliente\b/i
+    ],
+    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."
+  },
+  {
+    surface: "analysis",
+    nameOnly: true,
+    signals: [
+      /^\s*(?:re-?)?(?:investigat|analy[sz]|audit|review|document|assess|evaluat|research|map|inventor|examin|diagnos|verif|validat|benchmark)\w*\b/i,
+      /^\s*(?:auditar|auditoria|investigar|investigacion|revisar|revision|analizar|analisis|documentar|evaluar|evaluacion|diagnosticar|diagnostico|mapear|inventariar|verificar|verificacion|comprobar|estudiar|estudio)\b/i
+    ],
+    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`)."
+  },
+  {
+    surface: "ads-write",
+    // "Approve X" is a human decision, not a staged write — and the budget
+    // signals are broad enough to swallow it otherwise. Name-anchored so a
+    // description recalling an earlier approval doesn't veto real work.
+    exceptName: [/^\s*(?:approve|approval|sign[-\s]?off|aprobar|aprobacion)\b/i],
+    // Bare `keywords` is the work when it's the subject of the Task, but plain
+    // context when a description happens to discuss search terms.
+    nameOnlySignals: [/\b(?:keywords?|palabras\s+clave)\b/i],
+    signals: [
+      // Targeting.
+      /\b(?:geo|location|geographic|geografic\w*)[\s-]*(?:targeting|target|segmentacion)\b/i,
+      /\bsegmentacion\s+(?:geografica|por\s+ubicacion)\b/i,
+      /\bpresence[-\s_]?(?:only|or[-\s_]?interest)\b/i,
+      /\b(?:ad\s*schedul\w*|dayparting|calendario\s+de\s+anuncios)\b/i,
+      // Extensions / assets.
+      /\b(?:callouts?|sitelinks?|site\s*links?|structured\s+snippets?|price\s+extensions?|lead\s+form\s+extensions?|extensiones|asset\s+groups?)\b/i,
+      // Ad copy. Compound forms only — bare `headline` and `copy` belong to
+      // `landing`, and an RSA headline has to say so.
+      /\b(?:rsas?|responsive\s+search\s+ads?|ad\s+copy|copy\s+de\s+(?:los\s+)?anuncios)\b/i,
+      /\b(?:headline|titular|description)\s+(?:pool|set|slots?)\b/i,
+      /\bdisplay\s+paths?\b|\brutas?\s+visibles?\b/i,
+      // Keywords. `negatives` is bare in English because in this product's
+      // vocabulary the noun is always negative keywords; the Spanish side is
+      // feminine-only, because "resultados negativos" is a real phrase.
+      /\bmatch\s+types?\b|\bconcordancias?\b/i,
+      /\bnegatives?\b/i,
+      /\b(?:palabras\s+clave\s+)?negativas\b/i,
+      /\bkeyword\s+lists?\b|\blistas?\s+de\s+palabras\s+clave\b/i,
+      // Audiences. `LAL` is the operators' own shorthand for a lookalike and
+      // has no other reading in this corpus.
+      /\b(?:in-?market|affinity|audience\s+signals?|senales?\s+de\s+audiencia)\b/i,
+      /\b(?:audiencias?|lal)\b/i,
+      /\blistas?\s+de\s+(?:exclusion|remarketing)\b|\bexclusion\s+lists?\b/i,
+      // URLs.
+      /\btracking\s+(?:url\s+)?templates?\b|\bfinal\s+urls?\b|\bfinal\s+url\s+suffix\b/i,
+      // Bidding.
+      /\bbid\s+(?:adjustments?|modifiers?|strateg\w*)\b|\bajustes?\s+de\s+puja\b/i,
+      /\b(?:tcpa|troas|target\s+cpa|target\s+roas)\b/i,
+      // Lifecycle. Bare `campaign` is deliberately NOT a signal — it appears
+      // everywhere and would strip tag-manager and landing of correct
+      // routings, so every campaign-shaped rule needs a verb or a specific
+      // setting noun next to it.
+      // Bounded, and never across the name/description boundary. `ads` is an
+      // ordinary word in this domain, so an unbounded gap lets a verb in the
+      // name pair with a passing mention in the description — and since
+      // ads-write is evaluated first, that spurious match outranks the surface
+      // which should have answered.
+      re(String.raw`\b`, LIFECYCLE_VERB, String.raw`\b[^\n]{0,40}\b`, CAMPAIGN_ENTITY, String.raw`\b`),
+      // Budget. Two complementary shapes — verb before, quantity after — so a
+      // change stated either way lands, guarded by the `exceptName` veto above.
+      /\b(?:daily|campaign|lifetime|ad\s*set|minimum|min|competitor)\s+budgets?\b/i,
+      /\bpresupuestos?\b/i,
+      re(String.raw`\b`, BUDGET_VERB, String.raw`\b[\s\S]{0,24}\bbudgets?\b`),
+      /\bbudgets?\b[\s\S]{0,24}\b(?:at|to|cap|down|up|\d|%|€|\$)/i,
+      /\bnegative\s+keywords?\b/i,
+      /\b(?:lookalike|custom)\s+audience\b/i,
+      /\bswap\s+(?:the\s+)?creative\b/i
+    ],
+    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."
+  },
+  {
+    surface: "tag-manager",
+    signals: [
+      /\bgtm\b/i,
+      /\btag\s*manager\b/i,
+      /\bdata\s*layer\b/i,
+      /\bfiring\s+trigger\b/i,
+      /\bbuilt-?in\s+variables?\b/i,
+      /\bconsent\s+(?:mode|settings?|state)\b/i,
+      /\bga4\s+(?:config|configuration|event)\b/i,
+      /\bcontainer\s+(?:tag|trigger|variable)s?\b/i,
+      /\b(?:conversion|form|submit|submission|click|purchase|lead|custom)\s+event\b/i,
+      /\btrack\w*\b[\s\S]*\bevent\b/i,
+      /\beventos?\s+de\s+(?:formulario|conversion|clic|compra)\b/i,
+      /\bconsentimiento\b/i,
+      /\bmedicion\b/i
+    ],
+    except: [/\bserver-?\s?side\b/i, /\bsgtm\b/i, /\bhosting\b/i],
+    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."
+  },
+  {
+    surface: "site-tags",
+    signals: [
+      /\bpixel\b/i,
+      /\binsight\s+tag\b/i,
+      /\bclarity\b/i,
+      /\bhotjar\b/i,
+      /\bgtm\s+snippet\b/i,
+      /\bcapi\b/i,
+      /\b(?:install|add|remove|swap|instalar|colocar)\b[\s\S]*\b(?:snippet|script|tag)\b/i
+    ],
+    // Two vetoes. A structured snippet is a Google Ads extension, not a script
+    // on the page — `ads-write` claims it above, and this stops both rules
+    // being able to answer. Server-side delivery is infrastructure nobody here
+    // can provision, the same call `tag-manager` already makes for sGTM.
+    except: [/\bstructured\s+snippets?\b/i, /\bserver-?\s?side\b/i, /\bhosting\b/i],
+    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."
+  },
+  {
+    surface: "landing",
+    nameOnlySignals: [/\b(?:landing\s+pages?|landings?|hero|headline|above\s+the\s+fold|pagina)\b/i],
+    signals: [/\b(?:rewrite|tighten|restyle)\b[\s\S]*\b(?:copy|page|section)\b/i],
+    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."
+  },
+  {
+    surface: "flow",
+    signals: [/\b(?:form|flow)\s+(?:step|steps|branching|logic|redirect|behaviou?r)\b/i, /\bthank\s*you\s+redirect\b/i],
+    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 FAN_OUT_NUDGE_THRESHOLD = 2;
+var FAN_OUT_THRESHOLD = 3;
+var SCHEDULED_HINT = 'This reads as recurring/scheduled work. If it should run on a cadence or a future date, create a Scheduled Action instead \u2014 baker scheduled-actions create --cron "0 9 * * MON" (or --run-at; guide: `__tooling__/docs/tools/baker/scheduled-actions.md`). Do NOT capture "set up a scheduled action" as a Work Action.';
+function looksExecutable(name, description) {
+  const foldedName = fold(name);
+  const full = `${foldedName}
+${fold(description)}`;
+  for (const rule of SURFACE_RULES) {
+    const haystack = rule.nameOnly ? foldedName : full;
+    if (rule.except?.some((re2) => re2.test(full))) {
+      continue;
+    }
+    if (rule.exceptName?.some((re2) => re2.test(foldedName))) {
+      continue;
+    }
+    if (rule.signals.some((re2) => re2.test(haystack))) {
+      return { surface: rule.surface, hint: rule.hint };
+    }
+    if (rule.nameOnlySignals?.some((re2) => re2.test(foldedName))) {
+      return { surface: rule.surface, hint: rule.hint };
+    }
+  }
+  return null;
+}
+function buildCreateHints({
+  name,
+  description,
+  tempId,
+  tags,
+  prioritySet,
+  draftCreateCount
+}) {
+  const hints = [];
+  const advisory = advisoryHint(name, description);
+  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 advisoryHint(name, description) {
+  if (looksScheduled(name, description)) {
+    return { kind: "scheduled", hint: SCHEDULED_HINT };
+  }
+  const executable = looksExecutable(name, description);
+  return executable ? { kind: "executable", ...executable } : 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 / --q).`
+  ];
+}
+
+// src/commands/actions/skillCatalog.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+var DESCRIPTION_MAX = 600;
+var SKILLS_SUBPATH = join(".claude", "skills");
+var EXCLUDED_SKILLS = /* @__PURE__ */ new Set(["actions"]);
+function stripQuotes(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+    return trimmed.slice(1, -1).replace(/\\"/g, '"').replace(/\\n/g, "\n");
+  }
+  if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return trimmed.slice(1, -1).replace(/''/g, "'");
+  }
+  return trimmed;
+}
+function extractFrontmatterLines(md) {
+  if (!md.startsWith("---")) return null;
+  const end = md.indexOf("\n---", 3);
+  if (end === -1) return null;
+  return md.slice(md.indexOf("\n", 3) + 1, end).split("\n");
+}
+var BLOCK_SCALAR = /^([|>])[+-]?$/;
+function collectBlockLines(lines, start) {
+  const collected = [];
+  for (let i = start; i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    if (line.trim() === "") {
+      collected.push("");
+    } else if (/^\s/.test(line)) {
+      collected.push(line.trim());
+    } else {
+      break;
+    }
+  }
+  while (collected.length > 0 && collected.at(-1) === "") collected.pop();
+  return collected;
+}
+function foldLines(collected) {
+  const paragraphs = [];
+  let buffer = [];
+  for (const line of collected) {
+    if (line === "") {
+      if (buffer.length > 0) paragraphs.push(buffer.join(" "));
+      buffer = [];
+    } else {
+      buffer.push(line);
+    }
+  }
+  if (buffer.length > 0) paragraphs.push(buffer.join(" "));
+  return paragraphs.join("\n");
+}
+function readBlockScalar(lines, start, style) {
+  const collected = collectBlockLines(lines, start);
+  return style === "|" ? collected.join("\n") : foldLines(collected);
+}
+function readField(lines, field) {
+  for (let i = 0; i < lines.length; i++) {
+    const match = (lines[i] ?? "").match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!match || match[1] !== field) continue;
+    const inline = (match[2] ?? "").trim();
+    const scalar = inline.match(BLOCK_SCALAR);
+    if (scalar) {
+      return readBlockScalar(lines, i + 1, scalar[1]);
+    }
+    return stripQuotes(inline);
+  }
+  return null;
+}
+function parseSkillFrontmatter(md) {
+  const lines = extractFrontmatterLines(md);
+  if (!lines) return null;
+  const name = readField(lines, "name");
+  const description = readField(lines, "description");
+  if (!name || !description) return null;
+  const trimmed = description.length > DESCRIPTION_MAX ? `${description.slice(0, DESCRIPTION_MAX)}\u2026` : description;
+  return { name, description: trimmed };
+}
+function findSkillsDir(startDir) {
+  let dir = startDir;
+  for (; ; ) {
+    const candidate = join(dir, SKILLS_SUBPATH);
+    if (existsSync(candidate)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function readSkillCatalog(startDir) {
+  const skillsDir = findSkillsDir(startDir);
+  if (!skillsDir) return [];
+  const entries = [];
+  for (const dirent of readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!dirent.isDirectory() || EXCLUDED_SKILLS.has(dirent.name)) continue;
+    const skillFile = join(skillsDir, dirent.name, "SKILL.md");
+    if (!existsSync(skillFile)) continue;
+    try {
+      const parsed = parseSkillFrontmatter(readFileSync(skillFile, "utf8"));
+      if (parsed) entries.push(parsed);
+    } catch {
+    }
+  }
+  return entries.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// src/commands/actions/claim.ts
+registerSchema({
+  command: "actions.claim",
+  description: "Claim an action for the current chat (live \u2014 visible to other chats immediately). Claim only what you're actively working on now: it's required before `complete`, but NOT for `update` or `discard` (those stage without a claim). Returns action details plus a fast-model recommendation of which skills to load for the work (`recommendedSkills`) and a routing hint: load every skill that owns part of the work and the tool doc for each baker CLI family you'll use.",
+  args: {
+    id: { type: "string", description: "Action ID", required: true }
+  }
+});
+async function recommendSkills(actionId) {
+  const skills = readSkillCatalog(process.cwd());
+  if (skills.length === 0) return [];
+  const response = await apiPost("/api/actions/recommend-skills", {
+    actionId,
+    skills
+  });
+  return response.data.recommendations;
+}
+var ROUTING_HINT = "Actions often span several surfaces (a landing page plus a Google Ads change, a sheet pull plus an audience upload). Before starting, load EVERY skill that owns part of the work and read the tool doc (__tooling__/docs/tools/baker/<family>.md) for each baker CLI family you'll use. If the action references source material living in a connected tool (an email attachment, a call, a CRM record, a spreadsheet), reach for that tool too. If it describes recurring or future-dated work, it belongs on a schedule \u2014 see __tooling__/docs/tools/baker/scheduled-actions.md.";
+function buildHints(recommendations) {
+  if (recommendations.length === 0) {
+    return ["Review the action name, description, and tags above.", ROUTING_HINT];
+  }
+  return [
+    "Recommended skills for this action (load the ones you'll use):",
+    ...recommendations.map((r) => `  /${r.name} \u2014 ${r.reason}`),
+    "Suggestions come from the action's name/description/tags only \u2014 the work may need more.",
+    ROUTING_HINT
+  ];
+}
+var claimCommand = defineCommand({
+  meta: {
+    name: "claim",
+    description: "Claim an action so other chats see you're working on it. Required before `complete` (update and discard don't need a claim). Example: baker actions claim <action-id>"
+  },
+  args: {
+    id: { type: "positional", description: "Action ID", required: false },
+    "action-id": { type: "string", description: "Action ID", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      const chatId = requireChatId();
+      const response = await apiPost("/api/actions/claim", {
+        actionId: id,
+        chatId
+      });
+      let recommendedSkills = [];
+      try {
+        recommendedSkills = await recommendSkills(id);
+      } catch {
+      }
+      const data = response.data ? { ...response.data, recommendedSkills } : response.data;
+      writeJson({ ok: response.ok, data, hints: buildHints(recommendedSkills) });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+
 // src/commands/actions/complete.ts
 import { defineCommand as defineCommand2 } from "citty";
 registerSchema({
@@ -6739,7 +6743,11 @@ registerSchema({
       description: `User priority for the do-first ordering. One of: ${ACTION_PRIORITIES.join(", ")}.`,
       required: false
     },
-    "temp-id": { type: "string", description: "Custom tempId (auto-generated if omitted)", 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 = defineCommand3({
@@ -6752,7 +6760,7 @@ var createCommand = defineCommand3({
     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", required: false }
+    "temp-id": { type: "string", description: "Optional custom tempId (must start with `temp_`)", required: false }
   },
   run: async ({ args }) => {
     try {
@@ -6760,8 +6768,15 @@ var createCommand = defineCommand3({
       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 = args["temp-id"] || generateTempId();
+      const tempId = customTempId || generateTempId();
       const tags = parseTagList(args.tags);
       const priority = parsePriority(args.priority, { allowClear: false });
       const response = await apiPost("/api/actions/create", {
@@ -7114,7 +7129,8 @@ registerSchema({
       type: "string",
       description: `How many Tasks a flat list reads, newest first (only with --bucketed=false). Default: ${ACTIONS_LIST_DEFAULT_LIMIT}. When the read comes back full, hints[] says so \u2014 raise --limit to reach older Tasks.`,
       required: false
-    }
+    },
+    output: { type: "string", description: "Output format: json|md. Default: json", required: false }
   }
 });
 var listCommand2 = defineCommand8({
@@ -7126,33 +7142,102 @@ var listCommand2 = defineCommand8({
     bucketed: { type: "boolean", description: "Pre-bucket by chat", required: false, default: true },
     status: { type: "string", description: "Status filter (raw mode)", required: false },
     sort: { type: "string", description: "Order (raw mode): priority|recent", required: false },
-    limit: { type: "string", description: "How many Tasks to read (raw mode)", required: false }
+    limit: { type: "string", description: "How many Tasks to read (raw mode)", required: false },
+    output: { type: "string", description: "Output format: json|md", required: false }
   },
   run: async ({ args }) => {
     try {
-      const env = getEnv();
       const bucketed = args.bucketed !== false;
-      const body = { bucketed };
-      if (bucketed && env.BAKER_CHAT_ID) {
-        body.chatId = env.BAKER_CHAT_ID;
-      }
       const parsedLimit = args.limit === void 0 ? Number.NaN : Number.parseInt(String(args.limit), 10);
       const limit = Number.isFinite(parsedLimit) && parsedLimit > 0 ? parsedLimit : ACTIONS_LIST_DEFAULT_LIMIT;
-      if (!bucketed) {
-        if (args.status) {
-          body.status = args.status;
-        }
-        body.sort = args.sort === "recent" ? "recent" : "priority";
-        body.limit = limit;
-      }
+      const body = buildRequestBody(args, bucketed, limit);
       const response = await apiPost("/api/actions/list", body);
       const hints = !bucketed && response.ok && Array.isArray(response.data) ? buildListHints({ returned: response.data.length, limit }) : [];
-      writeJson(hints.length > 0 ? { ...response, hints } : response);
+      const envelope = hints.length > 0 ? { ...response, hints } : response;
+      if (args.output === "md" && envelope.ok) {
+        process.stdout.write(renderMarkdown(envelope.data, hints));
+        return;
+      }
+      writeJson(envelope);
     } catch (err) {
       failApi(err);
     }
   }
 });
+function buildRequestBody(args, bucketed, limit) {
+  const env = getEnv();
+  const body = { bucketed };
+  if (bucketed) {
+    if (env.BAKER_CHAT_ID) {
+      body.chatId = env.BAKER_CHAT_ID;
+    }
+    return body;
+  }
+  if (args.status) {
+    body.status = args.status;
+  }
+  body.sort = args.sort === "recent" ? "recent" : "priority";
+  body.limit = limit;
+  return body;
+}
+function toRow(entry) {
+  const nested = entry.action;
+  const doc = nested && typeof nested === "object" ? nested : entry;
+  const id = doc.id ?? doc._id ?? entry.id ?? entry._id ?? entry.tempId ?? "?";
+  const status = doc.status ?? entry.status ?? entry.draftStatus ?? "";
+  let hint = typeof entry.hint === "string" ? entry.hint.trim() : "";
+  if (!hint && entry.isBlocked === true) {
+    const open = typeof entry.openBlockerCount === "number" ? entry.openBlockerCount : null;
+    hint = open === null ? "blocked" : `blocked by ${open} open Task${open === 1 ? "" : "s"}`;
+  }
+  return {
+    id: String(id),
+    name: String(doc.name ?? entry.name ?? "(unnamed)"),
+    status: String(status),
+    hint
+  };
+}
+function renderEntry(entry) {
+  const row = toRow(entry);
+  const suffix = row.status ? ` [${row.status}]` : "";
+  const lines = [`- \`${row.id}\` ${row.name}${suffix}`];
+  if (row.hint) {
+    lines.push(`  ${row.hint}`);
+  }
+  return lines;
+}
+function renderBuckets(data) {
+  const lines = [];
+  for (const [bucket, entries] of Object.entries(data)) {
+    if (!Array.isArray(entries) || entries.length === 0) {
+      continue;
+    }
+    lines.push(`## ${bucket} (${entries.length})`);
+    for (const entry of entries) {
+      lines.push(...renderEntry(entry));
+    }
+    lines.push("");
+  }
+  return lines;
+}
+function renderMarkdown(data, hints) {
+  let lines;
+  if (Array.isArray(data)) {
+    lines = data.flatMap((entry) => renderEntry(entry));
+  } else if (data && typeof data === "object") {
+    lines = renderBuckets(data);
+  } else {
+    lines = [];
+  }
+  if (lines.length === 0) {
+    return "No Tasks matched.\n";
+  }
+  for (const hint of hints) {
+    lines.push(`> ${hint}`);
+  }
+  return `${lines.join("\n").trimEnd()}
+`;
+}
 
 // src/commands/actions/log.ts
 import { defineCommand as defineCommand9 } from "citty";
@@ -14278,7 +14363,7 @@ function sortFindings(findings) {
     return SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity];
   });
 }
-function renderMarkdown(result) {
+function renderMarkdown2(result) {
   const lines = [];
   lines.push(`# LinkedIn Ads Audit \u2014 ${result.account.name} (${result.account.id})`);
   lines.push("");
@@ -14363,7 +14448,7 @@ Examples:
       const result = { ...data, findings: sorted };
       const fmt = args.format ?? "json";
       if (fmt === "md") {
-        process.stdout.write(`${renderMarkdown(result)}
+        process.stdout.write(`${renderMarkdown2(result)}
 `);
         return;
       }
@@ -32200,7 +32285,7 @@ function outputRows(rows, args, response, cached) {
   }
   writeJsonEnvelope({ ...response, ...cached && { cached: true } });
 }
-function buildRequestBody(args, propertyId, useCache) {
+function buildRequestBody2(args, propertyId, useCache) {
   const body = { propertyId };
   if (args.preset) body.preset = args.preset;
   if (args.dimensions) body.dimensions = args.dimensions.split(",").map((d) => d.trim());
@@ -32275,7 +32360,7 @@ Free-form (escape hatch):
     }
     const propertyId = await resolvePropertyId(args);
     const useCache = !args["no-cache"];
-    const body = buildRequestBody(args, propertyId, useCache);
+    const body = buildRequestBody2(args, propertyId, useCache);
     const cacheKey = buildQueryCacheKey(propertyId, JSON.stringify(body));
     if (useCache) {
       const cached = cacheGet("ga4-queries", cacheKey);
@@ -32871,7 +32956,7 @@ function outputRows2(rows, args, response, cached) {
   }
   writeJsonEnvelope({ ...response, ...cached && { cached: true } });
 }
-function buildRequestBody2(args, siteUrl, useCache) {
+function buildRequestBody3(args, siteUrl, useCache) {
   const body = { siteUrl };
   if (args.preset) body.preset = args.preset;
   if (args.brand) body.brand = args.brand;
@@ -32955,7 +33040,7 @@ Free-form (escape hatch):
     }
     const siteUrl = await resolveSiteUrl(args);
     const useCache = !args["no-cache"];
-    const body = buildRequestBody2(args, siteUrl, useCache);
+    const body = buildRequestBody3(args, siteUrl, useCache);
     const cacheKey = buildQueryCacheKey(siteUrl, JSON.stringify(body));
     if (useCache) {
       const cached = cacheGet("gsc-queries", cacheKey);
@@ -34121,7 +34206,13 @@ registerSchema({
   command: "images.dimensions",
   description: "Return width, height, aspect ratio, and format for a local file or remote URL.",
   args: {
-    target: { type: "string", description: "Local file path or remote http(s) URL", required: true }
+    target: { type: "string", description: "Local file path or remote http(s) URL", required: true },
+    output: { type: "string", description: "Output format: json|md. Default: json", required: false },
+    fields: {
+      type: "string",
+      description: "Comma-separated field names to include (e.g. width,height)",
+      required: false
+    }
   }
 });
 var dimensionsCommand = defineCommand130({
@@ -34130,7 +34221,13 @@ var dimensionsCommand = defineCommand130({
     description: "Read image dimensions without decoding the full file.\n\nExample: baker images dimensions ./logo.png\nExample: baker images dimensions https://acme.com/hero.png"
   },
   args: {
-    target: { type: "positional", description: "Local file path or remote http(s) URL", required: false }
+    target: { type: "positional", description: "Local file path or remote http(s) URL", required: false },
+    output: { type: "string", description: "Output format: json|md", required: false },
+    // --fields is the flag an agent reaches for when it wants two numbers out of
+    // six. It used to be accepted silently and ignored (citty drops unknown
+    // flags), so the caller assumed the projection had failed and fell back to
+    // regexing raw JSON. Accepting it is cheaper than explaining it.
+    fields: { type: "string", description: "Comma-separated field names to include", required: false }
   },
   run: async ({ args }) => {
     try {
@@ -34148,17 +34245,23 @@ var dimensionsCommand = defineCommand130({
         });
         process.exit(1);
       }
-      writeJson({
-        ok: true,
-        data: {
-          target,
-          source: isRemoteUrl(target) ? "url" : "file",
-          width: dims.width,
-          height: dims.height,
-          aspectRatio: Math.round(dims.aspectRatio * 1e4) / 1e4,
-          format: dims.format
-        }
-      });
+      writeOutput(
+        {
+          ok: true,
+          data: {
+            target,
+            source: isRemoteUrl(target) ? "url" : "file",
+            width: dims.width,
+            height: dims.height,
+            aspectRatio: Math.round(dims.aspectRatio * 1e4) / 1e4,
+            format: dims.format
+          }
+        },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        false,
+        (record) => record
+      );
     } catch (err) {
       const message = err instanceof Error ? err.message : "Unexpected error";
       writeJson({ ok: false, error: { code: "IMAGE_PROCESSING_ERROR", message } });
@@ -35216,12 +35319,13 @@ var iconCommand = defineCommand138({
 
 // src/commands/images/ingest.ts
 import { defineCommand as defineCommand139 } from "citty";
+var SOURCE_VALUES = imageSourceSchema.options.join(" | ");
 registerSchema({
   command: "images.ingest",
   description: "Ingest a remote image URL into the library (full describe + embed).",
   args: {
     url: { type: "string", description: "Image URL to ingest", required: true },
-    source: { type: "string", description: "Image source enum", required: true },
+    source: { type: "string", description: `Where the image came from. One of: ${SOURCE_VALUES}`, required: true },
     "external-id": { type: "string", description: "Provider asset id", required: false },
     "external-url": { type: "string", description: "Canonical page URL", required: false },
     context: { type: "string", description: "Description context hint", required: false },
@@ -35236,7 +35340,7 @@ var ingestCommand = defineCommand139({
   },
   args: {
     url: { type: "positional", description: "Image URL", required: false },
-    source: { type: "string", description: "Source enum", required: false },
+    source: { type: "string", description: `Where the image came from. One of: ${SOURCE_VALUES}`, required: false },
     "external-id": { type: "string", description: "Provider asset id", required: false },
     "external-url": { type: "string", description: "Canonical page URL", required: false },
     context: { type: "string", description: "Description context", required: false },
@@ -35252,10 +35356,29 @@ var ingestCommand = defineCommand139({
         process.exit(1);
       }
       if (!source) {
-        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "--source is required" } });
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: "--source is required",
+            fix: `Pass one of: ${SOURCE_VALUES}. Use "website" for an asset pulled off a company's own site.`
+          }
+        });
+        process.exit(1);
+      }
+      const parsedSource = imageSourceSchema.safeParse(source);
+      if (!parsedSource.success) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `--source "${source}" is not a known image source`,
+            fix: `Pass one of: ${SOURCE_VALUES}. Use "website" for an asset pulled off a company's own site.`
+          }
+        });
         process.exit(1);
       }
-      const body = { url, source };
+      const body = { url, source: parsedSource.data };
       if (args["external-id"]) body.externalId = args["external-id"];
       if (args["external-url"]) body.externalUrl = args["external-url"];
       if (args.context) body.descriptionContext = args.context;