@koda-sl/baker-cli 0.232.0 → 0.233.0-dev.bfa5a91e4

package/dist/cli.js

@@ -58,7 +58,7 @@ import {
   ulid,
   validateCanvasDeep,
   ytDlpBlockSignal
-} from "./chunk-EKLAHWSF.js";
+} from "./chunk-CMPAHYLB.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -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", {
@@ -43301,8 +43316,8 @@ import { defineCommand as defineCommand178 } from "citty";
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
 var TEMP_ID_PREFIX = "temp_";
-function writeOk2(data) {
-  writeJson({ ok: true, data: data ?? null });
+function writeOk2(data, hints) {
+  writeJson({ ok: true, data: data ?? null, ...hints && hints.length > 0 ? { hints } : {} });
 }
 function failValidation4(message) {
   writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
@@ -43343,10 +43358,41 @@ function isPromptWithoutAgent(args, agentDisabled) {
 function failIfPromptWithoutAgent(args, agentDisabled) {
   if (isPromptWithoutAgent(args, agentDisabled)) {
     failValidation4(
-      "--prompt only applies when an agent is spawned; it has no effect with --no-spawn-agent or --spawn-agent false."
+      "--prompt only applies when a run does the work; it has no effect with --mode remind, --no-spawn-agent or --spawn-agent false."
     );
   }
 }
+function isModeAndSpawnAgentBothSet(args, mode) {
+  const spawnAgentGiven = args["spawn-agent"] !== void 0 || args["no-spawn-agent"] === true || args.noSpawnAgent === true;
+  return mode !== void 0 && spawnAgentGiven;
+}
+function failIfModeAndSpawnAgent(args, mode) {
+  if (isModeAndSpawnAgentBothSet(args, mode)) {
+    failValidation4("--mode and --spawn-agent/--no-spawn-agent set the same thing. Use --mode on its own.");
+  }
+}
+var TASK_MODES = [
+  { id: "remind", does: "Opens the Task on schedule and leaves it. Nothing runs." },
+  { id: "recommend", does: "Opens a Task with what it would change and why. Touches nothing itself." },
+  { id: "propose", does: "Does the work and leaves it for the user to review, then publish." },
+  { id: "publish", does: "Does the work and publishes it as soon as it finishes \u2014 nobody reviews it first." }
+];
+var TASK_MODE_IDS = TASK_MODES.map((mode) => mode.id);
+var TASK_MODE_ARG_DESCRIPTION = `How far a run of this task goes on its own. ${TASK_MODES.map(
+  (mode) => `${mode.id}: ${mode.does}`
+).join(" ")} Only set publish when the user asked for it outright \u2014 those runs go live unreviewed and can spend money.`;
+function isKnownTaskMode(raw) {
+  return typeof raw === "string" && TASK_MODE_IDS.some((id) => id === raw);
+}
+function parseModeFlag(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  if (!isKnownTaskMode(raw)) {
+    failValidation4(`--mode must be one of: ${TASK_MODE_IDS.join(", ")}.`);
+  }
+  return raw;
+}
 function parseBooleanFlag(raw, flagName) {
   if (raw === void 0) {
     return void 0;
@@ -43402,6 +43448,12 @@ registerSchema({
     },
     timezone: { type: "string", description: "IANA timezone override; defaults to Company Timezone", required: false },
     disabled: { type: "boolean", description: "Create disabled", required: false, default: false },
+    mode: {
+      type: "string",
+      description: `${TASK_MODE_ARG_DESCRIPTION} Defaults to propose, or to the template's own mode with --template.`,
+      required: false,
+      enum: TASK_MODE_IDS
+    },
     "no-spawn-agent": {
       type: "boolean",
       description: "Do not spawn an agent when this scheduled action fires",
@@ -43428,6 +43480,7 @@ var createCommand3 = defineCommand178({
     "run-at": { type: "string", description: "ISO UTC timestamp ending in Z", required: false },
     timezone: { type: "string", description: "IANA timezone override", required: false },
     disabled: { type: "boolean", description: "Create disabled", required: false, default: false },
+    mode: { type: "string", description: `One of: ${TASK_MODE_IDS.join(", ")}`, required: false },
     "no-spawn-agent": { type: "boolean", description: "Disable agent spawning", required: false, default: false },
     prompt: { type: "string", description: "Additional spawned-agent instructions", required: false },
     template: { type: "string", description: "Template id to run on this schedule", required: false }
@@ -43445,7 +43498,9 @@ var createCommand3 = defineCommand178({
       const schedule = buildScheduleBody(args, { required: true });
       const chatId = requireChatId();
       const noSpawnAgent = isNoSpawnAgentFlagSet(args);
-      failIfPromptWithoutAgent(args, noSpawnAgent);
+      const mode = parseModeFlag(args.mode);
+      failIfModeAndSpawnAgent(args, mode);
+      failIfPromptWithoutAgent(args, noSpawnAgent || mode === "remind");
       const body = {
         chatId,
         name,
@@ -43454,6 +43509,9 @@ var createCommand3 = defineCommand178({
         spawnAgent: !noSpawnAgent,
         ...schedule
       };
+      if (mode !== void 0) {
+        body.mode = mode;
+      }
       if (typeof args.prompt === "string") {
         body.agentPrompt = args.prompt;
       }
@@ -43795,6 +43853,12 @@ registerSchema({
     },
     timezone: { type: "string", description: "IANA timezone override", required: false },
     enabled: { type: "string", description: "Replacement enabled state", required: false, enum: ["true", "false"] },
+    mode: {
+      type: "string",
+      description: TASK_MODE_ARG_DESCRIPTION,
+      required: false,
+      enum: TASK_MODE_IDS
+    },
     "spawn-agent": {
       type: "string",
       description: "Replacement spawn-agent state",
@@ -43807,7 +43871,7 @@ registerSchema({
 var updateCommand3 = defineCommand184({
   meta: {
     name: "update",
-    description: "Stage a scheduled action update. Example: baker scheduled-actions update <id> --enabled false"
+    description: "Stage a scheduled action update. Examples: baker scheduled-actions update <id> --enabled false | baker scheduled-actions update <id> --mode publish"
   },
   args: {
     id: { type: "positional", description: "Scheduled action ID or temp_sched_* draft ID", required: false },
@@ -43822,6 +43886,7 @@ var updateCommand3 = defineCommand184({
     "run-at": { type: "string", description: "ISO UTC timestamp ending in Z", required: false },
     timezone: { type: "string", description: "IANA timezone override", required: false },
     enabled: { type: "string", description: "true|false", required: false },
+    mode: { type: "string", description: `One of: ${TASK_MODE_IDS.join(", ")}`, required: false },
     "spawn-agent": { type: "string", description: "true|false", required: false },
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   },
@@ -43850,24 +43915,30 @@ var updateCommand3 = defineCommand184({
         body.enabled = enabled;
         hasPatch = true;
       }
+      const mode = parseModeFlag(args.mode);
+      failIfModeAndSpawnAgent(args, mode);
+      if (mode !== void 0) {
+        body.mode = mode;
+        hasPatch = true;
+      }
       const spawnAgent = parseBooleanFlag(args["spawn-agent"], "--spawn-agent");
       if (spawnAgent !== void 0) {
         body.spawnAgent = spawnAgent;
         hasPatch = true;
       }
-      failIfPromptWithoutAgent(args, spawnAgent === false);
+      failIfPromptWithoutAgent(args, spawnAgent === false || mode === "remind");
       if (typeof args.prompt === "string") {
         body.agentPrompt = args.prompt;
         hasPatch = true;
       }
       if (!hasPatch) {
         failValidation4(
-          "Provide at least one of --name, --description, --cron, --run-at, --timezone, --enabled, --spawn-agent, --prompt."
+          "Provide at least one of --name, --description, --cron, --run-at, --timezone, --enabled, --mode, --spawn-agent, --prompt."
         );
       }
       body.chatId = requireChatId();
-      await apiPost("/api/scheduled-actions/update", body);
-      writeOk2();
+      const response = await apiPost("/api/scheduled-actions/update", body);
+      writeOk2(null, response.hints);
     } catch (err) {
       failApi2(err);
     }
@@ -43887,6 +43958,7 @@ Examples:
   baker scheduled-actions get <id-or-temp_sched_id>
   baker scheduled-actions create --name "Weekly report" --description "Prepare weekly report" --cron "0 9 * * MON"
   baker scheduled-actions update <id-or-temp_sched_id> --enabled false
+  baker scheduled-actions update <id-or-temp_sched_id> --mode publish   # what a run does on its own: remind|recommend|propose|publish
   baker scheduled-actions delete <id-or-temp_sched_id>
   baker scheduled-actions trigger <id>
 Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`