@koda-sl/baker-cli 0.496.0 → 0.497.0

package/dist/chunk-ZDAVSTEE.js

@@ -1,172 +0,0 @@
-import {
-  ACTION_TEMP_ID_PREFIX
-} from "./chunk-DAO63OOP.js";
-import {
-  ApiError
-} from "./chunk-6YLNY6CK.js";
-import {
-  writeJson
-} from "./chunk-QANGHND7.js";
-
-// src/commands/actions/tagError.ts
-var UNKNOWN_TAG_RE = /Unknown action tag\(s\): ([^.]+)\. Valid tags: ([^.]+)\./;
-function splitSlugs(list) {
-  return list.split(",").map((slug) => slug.trim()).filter((slug) => slug.length > 0);
-}
-function actionTagFix(message) {
-  const match = UNKNOWN_TAG_RE.exec(message);
-  if (!match) {
-    return null;
-  }
-  const [, unknownList, validList] = match;
-  const unknownTags = splitSlugs(unknownList ?? "");
-  const validTags = splitSlugs(validList ?? "");
-  const first = unknownTags[0];
-  if (first === void 0 || validTags.length === 0) {
-    return null;
-  }
-  return {
-    action: "retry_with_a_valid_tag",
-    explanation: `The tag(s) ${unknownTags.join(", ")} are not in this company's taxonomy. \`validTags\` below is the complete accepted set \u2014 pick from it and re-run the same command. Only mint a new tag when none of them names this work; a near-duplicate of an existing tag splits the backlog's filter instead of extending it.`,
-    unknownTags,
-    validTags,
-    mintCommand: `baker actions tags create --slug ${first} --description "<what ${first} groups>"`,
-    listCommand: "baker actions tags list"
-  };
-}
-
-// src/commands/actions/shared.ts
-function writeOk(data) {
-  writeJson({ ok: true, data: data ?? null });
-}
-function failValidation(message) {
-  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
-  process.exit(1);
-}
-function failApi(err) {
-  if (err instanceof ApiError) {
-    const fix = actionTagFix(err.message);
-    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
-    process.exit(1);
-  }
-  if (err instanceof Error) {
-    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-function generateTempId() {
-  return `${ACTION_TEMP_ID_PREFIX}${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
-}
-function isTempId(id) {
-  return id.startsWith(ACTION_TEMP_ID_PREFIX);
-}
-function parseTagList(value) {
-  if (typeof value !== "string") {
-    return void 0;
-  }
-  const tags = value.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
-  return [...new Set(tags)];
-}
-var ACTION_PRIORITIES = ["urgent", "high", "medium", "low"];
-function parsePriority(value, { allowClear }) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (typeof value !== "string") {
-    failValidation(
-      `--priority must be one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
-    );
-  }
-  const trimmed = value.trim().toLowerCase();
-  if (trimmed === "") {
-    if (allowClear) {
-      return null;
-    }
-    return void 0;
-  }
-  if (allowClear && (trimmed === "none" || trimmed === "clear")) {
-    return null;
-  }
-  if (ACTION_PRIORITIES.includes(trimmed)) {
-    return trimmed;
-  }
-  failValidation(
-    `Unknown --priority "${value}". Expected one of: ${ACTION_PRIORITIES.join(", ")}${allowClear ? ", or 'none' to clear" : ""}.`
-  );
-}
-var FAN_OUT_NUDGE_THRESHOLD = 2;
-var FAN_OUT_THRESHOLD = 3;
-function buildCreateHints({
-  advisory,
-  description,
-  tempId,
-  tags,
-  prioritySet,
-  draftCreateCount
-}) {
-  const hints = [];
-  if (advisory) {
-    hints.push(
-      `${advisory.hint} If nothing actually blocks it: baker actions draft remove ${tempId}, then do the work.`
-    );
-  }
-  if (draftCreateCount >= FAN_OUT_THRESHOLD) {
-    hints.push(
-      `${draftCreateCount} Tasks are staged in this chat. Re-read them with \`baker actions draft\`: can any be done now with a surface you already have, and do any two touch the same system (same container, same campaign, same page)? Those belong in ONE Task \u2014 fold them together with \`baker actions update\` and drop the extras with \`baker actions draft remove <tempId>\`.`
-    );
-  } else if (draftCreateCount === FAN_OUT_NUDGE_THRESHOLD) {
-    hints.push(
-      `Second Task staged in this chat. If these two land on the same system (same container, same campaign, same page) they are ONE Task \u2014 fold them with \`baker actions update\` and drop the extra with \`baker actions draft remove ${tempId}\`.`
-    );
-  }
-  hints.push(`Link dependencies: baker actions link --blocker <id> --blocked ${tempId}`);
-  if (!description) {
-    hints.push("Add description: baker actions update <tempId> --description '...' (what/why/where/done-when)");
-  }
-  if (!tags || tags.length === 0) {
-    hints.push(
-      "MISSING --tags. This action is invisible to the backlog's tag filter. Re-run with --tags <slug,...> (`baker actions tags list` for the taxonomy, `baker actions tags create --slug <slug>` to mint) \u2014 or `baker actions update <tempId> --tags <slug,...>`."
-    );
-  }
-  if (!prioritySet) {
-    hints.push(
-      `MISSING --priority. Without it this action ranks as 'normal' (medium) in the do-first ordering, so urgent/high client work won't surface first. Re-run with --priority ${ACTION_PRIORITIES.join("|")} \u2014 or \`baker actions update <tempId> --priority <level>\`.`
-    );
-  }
-  return hints;
-}
-var ACTIONS_LIST_DEFAULT_LIMIT = 500;
-function buildListHints({ returned, limit }) {
-  if (returned < limit) {
-    return [];
-  }
-  return [
-    `This list is capped at ${limit} Tasks and came back full, so older Tasks exist that are NOT shown. Do not treat it as the whole backlog \u2014 re-run with --limit ${limit * 2} (or narrow with --status / --search).`
-  ];
-}
-function buildGetHints(detail) {
-  if (detail?.action.status !== "pending" || detail.activeChat !== null) {
-    return [];
-  }
-  return [
-    `If you are working on this Task in this chat, claim it first so the Tasks page shows it in progress: baker actions claim ${detail.action._id}`
-  ];
-}
-
-export {
-  writeOk,
-  failValidation,
-  failApi,
-  generateTempId,
-  isTempId,
-  parseTagList,
-  ACTION_PRIORITIES,
-  parsePriority,
-  buildCreateHints,
-  ACTIONS_LIST_DEFAULT_LIMIT,
-  buildListHints,
-  buildGetHints
-};
-//# sourceMappingURL=chunk-ZDAVSTEE.js.map

package/dist/chunk-ZXCSOVS5.js

@@ -1,191 +0,0 @@
-import {
-  readRenderState,
-  recordSeen
-} from "./chunk-3N5A44NQ.js";
-import {
-  GLOBAL_PROMPT_FILE,
-  ideaBaseline,
-  isVideoBlueprint,
-  readIdeaAnchor,
-  recordedChanges
-} from "./chunk-GXGYTFZA.js";
-import {
-  loadCompositionMeta
-} from "./chunk-B7GF34FU.js";
-import {
-  parseRefExpr
-} from "./chunk-OL7JS4NG.js";
-import {
-  resolveAdaptFormats
-} from "./chunk-MCJ5I5LR.js";
-import {
-  apiPost
-} from "./chunk-6YLNY6CK.js";
-
-// src/commands/canvas/output-ratio.ts
-import { readFile } from "fs/promises";
-import path from "path";
-function definitionFormats(markdown) {
-  const front = markdown.match(/^---\n([\s\S]*?)\n---/)?.[1];
-  if (!front) return [];
-  const clean = (s) => s.trim().replace(/^["']|["']$/g, "");
-  const flow = front.match(/^formats:\s*\[([^\]]*)\]/m);
-  if (flow) return (flow[1] ?? "").split(",").map(clean).filter(Boolean);
-  const block = front.match(/^formats:\s*\n((?:\s+-\s+.*\n?)+)/m);
-  if (!block) return [];
-  return (block[1] ?? "").split("\n").map((l) => l.replace(/^\s+-\s+/, "")).map(clean).filter(Boolean);
-}
-function reduce(width, height) {
-  const gcd = (a, b) => b === 0 ? a : gcd(b, a % b);
-  const d = gcd(width, height);
-  return `${width / d}:${height / d}`;
-}
-async function ratiosOf(nodes, id, seen) {
-  const node = nodes.get(id);
-  if (!node || seen.has(id)) return null;
-  seen.add(id);
-  const p = node.params ?? {};
-  switch (node.type) {
-    case "image_generate":
-      return typeof p.aspect_ratio === "string" ? [p.aspect_ratio] : null;
-    case "image_aspect_adapt":
-      return [...resolveAdaptFormats(p)];
-    case "hyperframe_snapshot": {
-      if (typeof p.composition !== "string") return null;
-      const meta = await loadCompositionMeta(p.composition).catch(() => null);
-      return meta ? [reduce(meta.width, meta.height)] : null;
-    }
-    case "collect": {
-      const images = node.inputs?.images;
-      if (!Array.isArray(images)) return null;
-      const out = [];
-      for (const entry of images) {
-        const ref = typeof entry === "string" ? parseRefExpr(entry) : null;
-        if (!ref || ref.kind !== "ref") return null;
-        const upstream = await ratiosOf(nodes, ref.nodeId, seen);
-        if (!upstream) return null;
-        out.push(ref.index !== void 0 && upstream.length > 1 ? upstream[ref.index] ?? "" : upstream[0] ?? "");
-      }
-      return out.filter(Boolean);
-    }
-    default:
-      return null;
-  }
-}
-async function producedRatios(canvas) {
-  const c = canvas;
-  if (!Array.isArray(c?.nodes) || typeof c?.output?.node !== "string") return null;
-  const nodes = new Map(c.nodes.flatMap((n) => typeof n.id === "string" ? [[n.id, n]] : []));
-  return ratiosOf(nodes, c.output.node, /* @__PURE__ */ new Set());
-}
-function value(ratio) {
-  const [w, h] = ratio.split(":").map(Number);
-  return w && h ? w / h : null;
-}
-function outputRatioWarnings(declared, produced) {
-  if (!produced || produced.length === 0) return [];
-  const shapes = produced.flatMap((r) => value(r) ?? []);
-  return declared.flatMap((format) => {
-    const want = value(format);
-    if (want === null || shapes.some((s) => Math.abs(s / want - 1) <= 0.02)) return [];
-    return [
-      {
-        path: "output",
-        code: "OUTPUT_RATIO_MISMATCH",
-        severity: "warning",
-        message: `_definition.md declares ${format}, but this canvas delivers ${produced.join(", ")}. A ${format} placement would get the wrong shape: re-scaffold with that format, or fix the formats the creative declares.`
-      }
-    ];
-  });
-}
-async function outputRatioWarningsFor(canvas, canvasPath) {
-  const definition = await readFile(path.join(path.dirname(canvasPath), "_definition.md"), "utf8").catch(() => null);
-  if (!definition) return [];
-  return outputRatioWarnings(definitionFormats(definition), await producedRatios(canvas));
-}
-
-// src/commands/canvas/shown-version.ts
-import { z } from "zod";
-var ShownResponse = z.object({
-  data: z.object({
-    runId: z.string(),
-    sourceSha: z.string().optional(),
-    createdAt: z.number(),
-    canvasSnapshotUrl: z.string().optional()
-  })
-});
-var SnapshotEntry = z.object({ path: z.string(), url: z.string() });
-var SnapshotFiles = z.object({ canvas: SnapshotEntry.optional(), files: z.array(SnapshotEntry) });
-var HISTORY = {
-  shown: async (slug) => ShownResponse.parse(await apiPost("/api/creatives/run", { slug })).data,
-  file: async (url) => {
-    const res = await fetch(url);
-    return res.ok ? res.json() : null;
-  },
-  text: async (url) => {
-    const res = await fetch(url);
-    return res.ok ? res.text() : null;
-  }
-};
-async function shownVersion(canvasRoot, slug, sources = HISTORY) {
-  const here = await readRenderState(canvasRoot, slug);
-  if (here.rendered) return here;
-  const run = await sources.shown(slug).catch(() => null);
-  if (!run) return here;
-  const drawn = run.canvasSnapshotUrl ? await drawnFiles(run.canvasSnapshotUrl, sources) : {};
-  return {
-    ...here,
-    rendered: { sourceSha: run.sourceSha ?? "", runId: run.runId, at: run.createdAt },
-    ...drawn.prompt !== void 0 ? { prompt: drawn.prompt } : {},
-    ...drawn.definition !== void 0 ? { definition: drawn.definition } : {},
-    ...drawn.video ? { video: drawn.video } : {}
-  };
-}
-async function drawnFiles(manifestUrl, sources) {
-  const manifest = SnapshotFiles.safeParse(await sources.file(manifestUrl).catch(() => null));
-  const files = manifest.success ? manifest.data.files : [];
-  const urlOf = (file) => files.find((f) => f.path === file)?.url;
-  const promptUrl = urlOf(GLOBAL_PROMPT_FILE);
-  const definitionUrl = urlOf("_definition.md");
-  const read = (url) => url ? sources.file(url).catch(() => null) : Promise.resolve(null);
-  const sceneEntries = files.filter((f) => /^scenes\/[^/]+\.json$/.test(f.path)).sort((a, b) => a.path.localeCompare(b.path));
-  const [prompt, definition, scenes, canvas, adSpec] = await Promise.all([
-    read(promptUrl),
-    definitionUrl ? sources.text(definitionUrl).catch(() => null) : null,
-    Promise.all(sceneEntries.map((f) => read(f.url))),
-    read(manifest.success ? manifest.data.canvas?.url : void 0),
-    read(urlOf("ad.spec.json"))
-  ]);
-  return {
-    ...prompt !== null && prompt !== void 0 ? { prompt } : {},
-    ...typeof definition === "string" ? { definition } : {},
-    video: { scenes: scenes.filter((s) => s !== null), canvas, adSpec }
-  };
-}
-
-// src/commands/canvas/shown-anchor.ts
-async function shownBaseline(opts) {
-  const state = await readRenderState(opts.canvasRoot, opts.slug);
-  const known = opts.turnId !== void 0 && state.seen?.turnId === opts.turnId;
-  let fallback;
-  if (!known && !state.anchor) {
-    const shown = opts.shown ?? await shownVersion(opts.canvasRoot, opts.slug, opts.sources);
-    if (shown.rendered && shown.prompt !== void 0) {
-      const video = typeof shown.prompt === "object" && shown.prompt !== null && isVideoBlueprint(shown.prompt);
-      const recorded = shown.video;
-      const unrecorded = video && (!recorded || recorded.canvas === null || recorded.canvas === void 0);
-      const anchor = unrecorded ? void 0 : (await readIdeaAnchor(opts.creativeDir, { spec: shown.prompt, ...video && recorded ? { recorded } : {} }))?.anchor;
-      if (anchor) fallback = { ...anchor, changes: shown.definition ? recordedChanges(shown.definition) : [] };
-    }
-  }
-  const { baseline, seen } = ideaBaseline(state, opts.turnId, fallback);
-  if (seen && opts.record) await recordSeen(opts.canvasRoot, opts.slug, seen);
-  return baseline ? { baseline } : {};
-}
-
-export {
-  outputRatioWarningsFor,
-  shownVersion,
-  shownBaseline
-};
-//# sourceMappingURL=chunk-ZXCSOVS5.js.map

package/dist/claim-SVDCQ2AI.js

@@ -1,197 +0,0 @@
-import {
-  failApi,
-  failValidation
-} from "./chunk-ZDAVSTEE.js";
-import "./chunk-DAO63OOP.js";
-import "./chunk-GXDLWBOY.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-XQIOCIDO.js";
-import "./chunk-WTJSMYY2.js";
-import {
-  apiPost,
-  validateConvexId
-} from "./chunk-6YLNY6CK.js";
-import "./chunk-D5NEIESR.js";
-import {
-  requireChatId
-} from "./chunk-57KKVDDR.js";
-import {
-  registerSchema,
-  writeJson
-} from "./chunk-QANGHND7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/actions/claim.ts
-import { defineCommand } from "citty";
-
-// 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-agents.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);
-    }
-  }
-});
-export {
-  claimCommand
-};
-//# sourceMappingURL=claim-SVDCQ2AI.js.map

package/dist/claim-SVDCQ2AI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/actions/claim.ts","../src/commands/actions/skillCatalog.ts"],"sourcesContent":["import type { ActionsClaimResponse, ActionsRecommendSkillsResponse, SkillRecommendation } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost, validateConvexId } from \"../../client.ts\";\nimport { requireChatId } from \"../../env.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi, failValidation } from \"./shared.ts\";\nimport { readSkillCatalog } from \"./skillCatalog.ts\";\n\nregisterSchema({\n  command: \"actions.claim\",\n  description:\n    \"Claim an action for the current chat (live — 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.\",\n  args: {\n    id: { type: \"string\", description: \"Action ID\", required: true },\n  },\n});\n\nasync function recommendSkills(actionId: string): Promise<SkillRecommendation[]> {\n  const skills = readSkillCatalog(process.cwd());\n  if (skills.length === 0) return [];\n  const response = await apiPost<ActionsRecommendSkillsResponse>(\"/api/actions/recommend-skills\", {\n    actionId,\n    skills,\n  });\n  return response.data.recommendations;\n}\n\n// Keep in sync with the claim-hint block in scripts/skill-routing-evals/run.mjs —\n// the action-claim evals embed this nudge so they test the real production surface.\nconst ROUTING_HINT =\n  \"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 — see __tooling__/docs/tools/baker/scheduled-agents.md.\";\n\nfunction buildHints(recommendations: SkillRecommendation[]): string[] {\n  if (recommendations.length === 0) {\n    return [\"Review the action name, description, and tags above.\", ROUTING_HINT];\n  }\n  return [\n    \"Recommended skills for this action (load the ones you'll use):\",\n    ...recommendations.map((r) => `  /${r.name} — ${r.reason}`),\n    \"Suggestions come from the action's name/description/tags only — the work may need more.\",\n    ROUTING_HINT,\n  ];\n}\n\nexport const claimCommand = defineCommand({\n  meta: {\n    name: \"claim\",\n    description:\n      \"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>\",\n  },\n  args: {\n    id: { type: \"positional\", description: \"Action ID\", required: false },\n    \"action-id\": { type: \"string\", description: \"Action ID\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const id = (args.id as string | undefined) || (args[\"action-id\"] as string | undefined);\n      if (!id) {\n        failValidation(\"Action ID is required.\");\n      }\n      validateConvexId(id);\n      const chatId = requireChatId();\n      const response = await apiPost<ActionsClaimResponse>(\"/api/actions/claim\", {\n        actionId: id,\n        chatId,\n      });\n\n      let recommendedSkills: SkillRecommendation[] = [];\n      try {\n        recommendedSkills = await recommendSkills(id);\n      } catch {\n        // Recommendation is best-effort — a claim must never fail because the hint could not be produced.\n      }\n\n      const data = response.data ? { ...response.data, recommendedSkills } : response.data;\n      writeJson({ ok: response.ok, data, hints: buildHints(recommendedSkills) });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n","import { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\ninterface SkillCatalogEntry {\n  name: string;\n  description: string;\n}\n\nconst DESCRIPTION_MAX = 600;\nconst SKILLS_SUBPATH = join(\".claude\", \"skills\");\n\n/** The backlog workflow lives in the actions tool doc, not a skill — never recommend a legacy `actions` skill a stale scaffold may still carry. */\nconst EXCLUDED_SKILLS = new Set([\"actions\"]);\n\nfunction stripQuotes(value: string): string {\n  const trimmed = value.trim();\n  if (trimmed.startsWith('\"') && trimmed.endsWith('\"')) {\n    return trimmed.slice(1, -1).replace(/\\\\\"/g, '\"').replace(/\\\\n/g, \"\\n\");\n  }\n  // YAML single-quoted scalars only escape a literal quote by doubling it ('').\n  if (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\")) {\n    return trimmed.slice(1, -1).replace(/''/g, \"'\");\n  }\n  return trimmed;\n}\n\nfunction extractFrontmatterLines(md: string): string[] | null {\n  if (!md.startsWith(\"---\")) return null;\n  const end = md.indexOf(\"\\n---\", 3);\n  if (end === -1) return null;\n  return md.slice(md.indexOf(\"\\n\", 3) + 1, end).split(\"\\n\");\n}\n\nconst BLOCK_SCALAR = /^([|>])[+-]?$/;\n\nfunction collectBlockLines(lines: string[], start: number): string[] {\n  const collected: string[] = [];\n  for (let i = start; i < lines.length; i++) {\n    const line = lines[i] ?? \"\";\n    if (line.trim() === \"\") {\n      collected.push(\"\");\n    } else if (/^\\s/.test(line)) {\n      collected.push(line.trim());\n    } else {\n      break; // dedented to a new top-level key — block is over\n    }\n  }\n  while (collected.length > 0 && collected.at(-1) === \"\") collected.pop();\n  return collected;\n}\n\n/** Folded (`>`): join lines with spaces, blank lines become paragraph breaks. */\nfunction foldLines(collected: string[]): string {\n  const paragraphs: string[] = [];\n  let buffer: string[] = [];\n  for (const line of collected) {\n    if (line === \"\") {\n      if (buffer.length > 0) paragraphs.push(buffer.join(\" \"));\n      buffer = [];\n    } else {\n      buffer.push(line);\n    }\n  }\n  if (buffer.length > 0) paragraphs.push(buffer.join(\" \"));\n  return paragraphs.join(\"\\n\");\n}\n\n/** Join a YAML block scalar's indented continuation lines: literal (`|`) keeps line breaks, folded (`>`) joins with spaces. */\nfunction readBlockScalar(lines: string[], start: number, style: \"|\" | \">\"): string {\n  const collected = collectBlockLines(lines, start);\n  return style === \"|\" ? collected.join(\"\\n\") : foldLines(collected);\n}\n\nfunction readField(lines: string[], field: string): string | null {\n  for (let i = 0; i < lines.length; i++) {\n    const match = (lines[i] ?? \"\").match(/^([A-Za-z0-9_-]+):\\s*(.*)$/);\n    if (!match || match[1] !== field) continue;\n    const inline = (match[2] ?? \"\").trim();\n    const scalar = inline.match(BLOCK_SCALAR);\n    if (scalar) {\n      return readBlockScalar(lines, i + 1, scalar[1] as \"|\" | \">\");\n    }\n    return stripQuotes(inline);\n  }\n  return null;\n}\n\nexport function parseSkillFrontmatter(md: string): SkillCatalogEntry | null {\n  const lines = extractFrontmatterLines(md);\n  if (!lines) return null;\n  const name = readField(lines, \"name\");\n  const description = readField(lines, \"description\");\n  if (!name || !description) return null;\n  const trimmed = description.length > DESCRIPTION_MAX ? `${description.slice(0, DESCRIPTION_MAX)}…` : description;\n  return { name, description: trimmed };\n}\n\nexport function findSkillsDir(startDir: string): string | null {\n  let dir = startDir;\n  for (;;) {\n    const candidate = join(dir, SKILLS_SUBPATH);\n    if (existsSync(candidate)) return candidate;\n    const parent = dirname(dir);\n    if (parent === dir) return null;\n    dir = parent;\n  }\n}\n\nexport function readSkillCatalog(startDir: string): SkillCatalogEntry[] {\n  const skillsDir = findSkillsDir(startDir);\n  if (!skillsDir) return [];\n\n  const entries: SkillCatalogEntry[] = [];\n  for (const dirent of readdirSync(skillsDir, { withFileTypes: true })) {\n    if (!dirent.isDirectory() || EXCLUDED_SKILLS.has(dirent.name)) continue;\n    const skillFile = join(skillsDir, dirent.name, \"SKILL.md\");\n    if (!existsSync(skillFile)) continue;\n    try {\n      const parsed = parseSkillFrontmatter(readFileSync(skillFile, \"utf8\"));\n      if (parsed) entries.push(parsed);\n    } catch {\n      // Unreadable skill file — skip it, never block the claim.\n    }\n  }\n  return entries.sort((a, b) => a.name.localeCompare(b.name));\n}\n"],"mappings":"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","names":[]}