@koda-sl/baker-cli 0.99.1 → 0.100.0

package/README.md

@@ -2354,7 +2354,7 @@ baker actions log --from 2026-06-01 --to 2026-06-15   # explicit ISO window (ove
 baker actions get <action-id>
 baker actions status temp_hero jx123       # batch resolve real IDs and temp_* refs
 
-baker actions claim <action-id>            # live — returns action details + skill-loading hints
+baker actions claim <action-id>            # live — returns action details + a fast-model list of skills to load (recommendedSkills)
 baker actions release <action-id>
 
 baker actions create --name "Build hero" --priority high --tags landing,creative --description "..."
@@ -2417,7 +2417,7 @@ baker actions draft clear                   # drop everything staged in this cha
 Permissions enforced server-side:
 
 - Only `claim`/`release` mutate live state.
-- `claim` returns action details (`id`, `name`, `description`) and a `hints` array recommending you review the action context and load relevant skills.
+- `claim` returns action details (`id`, `name`, `description`) plus `recommendedSkills` — a fast model reads the action's name/description/tags against the local `.claude/skills/` catalog and returns the skills (`{ name, reason }`) most worth loading for the work, echoed as `/skill — reason` lines in `hints`. It is best-effort: if the catalog is absent or the model call fails, the claim still succeeds and falls back to the generic "review and load relevant skills" hint.
 - `update`, `complete`, `discard`, `unlink` require the action to be claimed by the current chat — otherwise the API returns `FORBIDDEN` with a hint to claim first.
 - Claiming an action already claimed by another chat returns `CONFLICT` with the other chat's title — pick a different action.
 - All staged ops are reverted automatically when the chat is discarded.

package/dist/cli.js

@@ -516,14 +516,140 @@ ${description}`;
   return SCHEDULE_SIGNALS.some((re) => re.test(haystack));
 }
 
+// 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). Returns action details with tags and description to help decide which skills to load.",
+  description: "Claim an action for the current chat (live \u2014 visible to other chats immediately). Returns action details plus a fast-model recommendation of which skills to load for the work (`recommendedSkills`).",
   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 ?? [];
+}
+function buildHints(recommendations) {
+  if (recommendations.length === 0) {
+    return [
+      "Review the action name, description, and tags above \u2014 then load any skills that would help you complete this work."
+    ];
+  }
+  return [
+    "Recommended skills for this action (load the ones you'll use):",
+    ...recommendations.map((r) => `  /${r.name} \u2014 ${r.reason}`),
+    "Suggestions from the action's name/description/tags \u2014 load others if the work needs them."
+  ];
+}
 var claimCommand = defineCommand({
   meta: {
     name: "claim",
@@ -545,10 +671,13 @@ var claimCommand = defineCommand({
         actionId: id,
         chatId
       });
-      const hints = [
-        "Review the action name, description, and tags above \u2014 then load any skills that would help you complete this work."
-      ];
-      writeJson({ ...response, hints });
+      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);
     }
@@ -1396,12 +1525,12 @@ import { defineCommand as defineCommand19 } from "citty";
 
 // src/commands/ads/cache.ts
 import { createHash } from "crypto";
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, rmSync, writeFileSync } from "fs";
 import { homedir } from "os";
-import { join } from "path";
-var CACHE_DIR = join(homedir(), ".baker", "cache", "ads");
+import { join as join2 } from "path";
+var CACHE_DIR = join2(homedir(), ".baker", "cache", "ads");
 function ensureDir(dir) {
-  if (!existsSync(dir)) {
+  if (!existsSync2(dir)) {
     mkdirSync(dir, { recursive: true });
   }
 }
@@ -1409,17 +1538,17 @@ function hashKey(key) {
   return createHash("sha256").update(key).digest("hex").slice(0, 16);
 }
 function cachePath(category, key) {
-  const dir = join(CACHE_DIR, category);
+  const dir = join2(CACHE_DIR, category);
   ensureDir(dir);
-  return join(dir, `${hashKey(key)}.json`);
+  return join2(dir, `${hashKey(key)}.json`);
 }
 function cacheGet(category, key) {
   const path11 = cachePath(category, key);
-  if (!existsSync(path11)) {
+  if (!existsSync2(path11)) {
     return null;
   }
   try {
-    const raw = readFileSync(path11, "utf-8");
+    const raw = readFileSync2(path11, "utf-8");
     const entry = JSON.parse(raw);
     if (entry.expiresAt < Date.now()) {
       rmSync(path11, { force: true });
@@ -3166,7 +3295,7 @@ var library = defineCommand27({
 });
 
 // src/commands/ads/google/query.ts
-import { appendFileSync, existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { appendFileSync, existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import { resolve } from "path";
 import { defineCommand as defineCommand28 } from "citty";
 
@@ -3443,7 +3572,7 @@ function extractFields(rows) {
 function writeRowsToFile(filePath, rows, fields, append) {
   const ext = filePath.split(".").pop()?.toLowerCase();
   if (ext === "csv") {
-    if (!append || !existsSync2(filePath)) {
+    if (!append || !existsSync3(filePath)) {
       writeFileSync2(filePath, `${toCsvRow(fields)}
 `, "utf-8");
     }
@@ -3452,15 +3581,15 @@ function writeRowsToFile(filePath, rows, fields, append) {
 `, "utf-8");
   } else if (ext === "jsonl") {
     const lines = rows.map((row) => JSON.stringify(row));
-    if (append && existsSync2(filePath)) {
+    if (append && existsSync3(filePath)) {
       appendFileSync(filePath, `${lines.join("\n")}
 `, "utf-8");
     } else {
       writeFileSync2(filePath, `${lines.join("\n")}
 `, "utf-8");
     }
-  } else if (append && existsSync2(filePath)) {
-    const existing = JSON.parse(readFileSync2(filePath, "utf-8"));
+  } else if (append && existsSync3(filePath)) {
+    const existing = JSON.parse(readFileSync3(filePath, "utf-8"));
     writeFileSync2(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
   } else {
     writeFileSync2(filePath, JSON.stringify(rows, null, 2), "utf-8");
@@ -4596,7 +4725,7 @@ Examples \u2014 common AI questions:
 });
 
 // src/commands/ads/linkedin/audience-size.ts
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 import { defineCommand as defineCommand33 } from "citty";
 function loadTargeting(args) {
   const inline = args.targeting;
@@ -4610,7 +4739,7 @@ function loadTargeting(args) {
   const file = args["targeting-file"];
   if (file) {
     try {
-      return JSON.parse(readFileSync3(file, "utf-8"));
+      return JSON.parse(readFileSync4(file, "utf-8"));
     } catch (e) {
       handleLinkedinError(
         new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
@@ -4789,7 +4918,7 @@ Examples:
 });
 
 // src/commands/ads/linkedin/bid-pricing.ts
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 import { defineCommand as defineCommand35 } from "citty";
 function loadTargeting2(args) {
   const inline = args.targeting;
@@ -4803,7 +4932,7 @@ function loadTargeting2(args) {
   const file = args["targeting-file"];
   if (file) {
     try {
-      return JSON.parse(readFileSync4(file, "utf-8"));
+      return JSON.parse(readFileSync5(file, "utf-8"));
     } catch (e) {
       handleLinkedinError(
         new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
@@ -5367,7 +5496,7 @@ Subcommands:
 });
 
 // src/commands/ads/linkedin/forecast.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync6 } from "fs";
 import { defineCommand as defineCommand43 } from "citty";
 function loadTargeting3(args) {
   const inline = args.targeting;
@@ -5381,7 +5510,7 @@ function loadTargeting3(args) {
   const file = args["targeting-file"];
   if (file) {
     try {
-      return JSON.parse(readFileSync5(file, "utf-8"));
+      return JSON.parse(readFileSync6(file, "utf-8"));
     } catch (e) {
       handleLinkedinError(
         new Error(`Failed to read --targeting-file: ${e instanceof Error ? e.message : "I/O error"}`)
@@ -8849,7 +8978,7 @@ import { defineCommand as defineCommand83 } from "citty";
 import { execFile as execFile2 } from "child_process";
 import { mkdtemp, readdir as readdir2, readFile as readFile4, rm as rm2 } from "fs/promises";
 import { tmpdir } from "os";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 import { promisify as promisify2 } from "util";
 var execFileAsync2 = promisify2(execFile2);
 var PYSCENEDETECT_THRESHOLD = 18;
@@ -8892,7 +9021,7 @@ function parsePySceneDetectCsvCuts(csv) {
   return [...new Set(cuts)].sort((a, b) => a - b);
 }
 async function runSceneDetectOnce(filePath, threshold, minSceneLenS, timeoutMs) {
-  const outDir = await mkdtemp(join2(tmpdir(), "baker-scenedetect-"));
+  const outDir = await mkdtemp(join3(tmpdir(), "baker-scenedetect-"));
   try {
     await execFileAsync2(
       "scenedetect",
@@ -8913,7 +9042,7 @@ async function runSceneDetectOnce(filePath, threshold, minSceneLenS, timeoutMs)
     );
     const csvName = (await readdir2(outDir)).find((f) => f.toLowerCase().endsWith(".csv"));
     if (!csvName) return [];
-    return parsePySceneDetectCsvCuts(await readFile4(join2(outDir, csvName), "utf-8"));
+    return parsePySceneDetectCsvCuts(await readFile4(join3(outDir, csvName), "utf-8"));
   } finally {
     await rm2(outDir, { recursive: true, force: true });
   }
@@ -11012,15 +11141,15 @@ function xfadeSpineArgs(clips) {
   let cur = "c0";
   let accLen = clipInputLen(clips[0]);
   for (let k = 0; k < n - 1; k++) {
-    const join4 = clips[k].out;
+    const join5 = clips[k].out;
     const next = `c${k + 1}`;
     const out = k === n - 2 ? "v" : `j${k + 1}`;
-    if (join4) {
-      const offset = Math.max(0, accLen - join4.dur);
+    if (join5) {
+      const offset = Math.max(0, accLen - join5.dur);
       filt.push(
-        `[${cur}][${next}]xfade=transition=${join4.xfade}:duration=${join4.dur.toFixed(3)}:offset=${offset.toFixed(3)}[${out}]`
+        `[${cur}][${next}]xfade=transition=${join5.xfade}:duration=${join5.dur.toFixed(3)}:offset=${offset.toFixed(3)}[${out}]`
       );
-      accLen = accLen - join4.dur + clipInputLen(clips[k + 1]);
+      accLen = accLen - join5.dur + clipInputLen(clips[k + 1]);
     } else {
       filt.push(`[${cur}][${next}]concat=n=2:v=1[${out}]`);
       accLen += clipInputLen(clips[k + 1]);
@@ -11457,9 +11586,9 @@ function videoReport(input, elementsInput) {
 }
 
 // src/commands/canvas/composition-path.ts
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import path6 from "path";
-function resolveShippedCanvasDir(name, startDir, exists = existsSync3, maxDepth = 8) {
+function resolveShippedCanvasDir(name, startDir, exists = existsSync4, maxDepth = 8) {
   const rel = path6.join("canvas", name);
   let dir = startDir;
   for (let i = 0; i < maxDepth; i++) {
@@ -12323,7 +12452,7 @@ Examples:
 });
 
 // src/commands/ga4/query.ts
-import { appendFileSync as appendFileSync2, existsSync as existsSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
+import { appendFileSync as appendFileSync2, existsSync as existsSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve2 } from "path";
 import { defineCommand as defineCommand91 } from "citty";
 
@@ -12397,7 +12526,7 @@ function writeRowsToFile2(filePath, rows, append) {
   const fields = extractFields2(rows);
   const ext = filePath.split(".").pop()?.toLowerCase();
   if (ext === "csv") {
-    if (!append || !existsSync4(filePath)) {
+    if (!append || !existsSync5(filePath)) {
       writeFileSync4(filePath, `${toCsvRow(fields)}
 `, "utf-8");
     }
@@ -12408,13 +12537,13 @@ function writeRowsToFile2(filePath, rows, append) {
     const lines = rows.map((row) => JSON.stringify(row));
     const content = `${lines.join("\n")}
 `;
-    if (append && existsSync4(filePath)) {
+    if (append && existsSync5(filePath)) {
       appendFileSync2(filePath, content, "utf-8");
     } else {
       writeFileSync4(filePath, content, "utf-8");
     }
-  } else if (append && existsSync4(filePath)) {
-    const existing = JSON.parse(readFileSync6(filePath, "utf-8"));
+  } else if (append && existsSync5(filePath)) {
+    const existing = JSON.parse(readFileSync7(filePath, "utf-8"));
     writeFileSync4(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
   } else {
     writeFileSync4(filePath, JSON.stringify(rows, null, 2), "utf-8");
@@ -12554,7 +12683,7 @@ Examples:
 import { defineCommand as defineCommand96 } from "citty";
 
 // src/commands/gsc/query.ts
-import { appendFileSync as appendFileSync3, existsSync as existsSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
+import { appendFileSync as appendFileSync3, existsSync as existsSync6, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "fs";
 import { resolve as resolve3 } from "path";
 import { defineCommand as defineCommand93 } from "citty";
 
@@ -12683,7 +12812,7 @@ function writeRowsToFile3(filePath, rows, append) {
   const fields = extractFields3(rows);
   const ext = filePath.split(".").pop()?.toLowerCase();
   if (ext === "csv") {
-    if (!append || !existsSync5(filePath)) {
+    if (!append || !existsSync6(filePath)) {
       writeFileSync5(filePath, `${toCsvRow(fields)}
 `, "utf-8");
     }
@@ -12693,13 +12822,13 @@ function writeRowsToFile3(filePath, rows, append) {
   } else if (ext === "jsonl") {
     const content = `${rows.map((row) => JSON.stringify(row)).join("\n")}
 `;
-    if (append && existsSync5(filePath)) {
+    if (append && existsSync6(filePath)) {
       appendFileSync3(filePath, content, "utf-8");
     } else {
       writeFileSync5(filePath, content, "utf-8");
     }
-  } else if (append && existsSync5(filePath)) {
-    const existing = JSON.parse(readFileSync7(filePath, "utf-8"));
+  } else if (append && existsSync6(filePath)) {
+    const existing = JSON.parse(readFileSync8(filePath, "utf-8"));
     writeFileSync5(filePath, JSON.stringify([...existing, ...rows], null, 2), "utf-8");
   } else {
     writeFileSync5(filePath, JSON.stringify(rows, null, 2), "utf-8");
@@ -12979,7 +13108,7 @@ function cropSprite(input, region) {
 // src/lib/image/io.ts
 import { randomBytes } from "crypto";
 import { glob as fsGlob, readFile as readFile10, rename, stat as stat2, writeFile as writeFile4 } from "fs/promises";
-import { dirname, extname as extname2, join as join3, resolve as resolve4 } from "path";
+import { dirname as dirname2, extname as extname2, join as join4, resolve as resolve4 } from "path";
 var REMOTE_RE = /^https?:\/\//i;
 var GLOB_RE = /[*?[\]{}]/;
 function isRemoteUrl(value) {
@@ -13029,14 +13158,14 @@ async function resolveOutputPath(inputPath, outputArg, options) {
   if (!outputArg) return base;
   if (options.multipleInputs || await isDirectory(outputArg)) {
     const filename = base.split("/").pop() ?? "out.png";
-    return join3(outputArg, filename);
+    return join4(outputArg, filename);
   }
   return outputArg;
 }
 async function atomicWrite(targetPath, data) {
   const absolute = resolve4(targetPath);
-  const dir = dirname(absolute);
-  const tmp = join3(dir, `.baker-image-${randomBytes(8).toString("hex")}.tmp`);
+  const dir = dirname2(absolute);
+  const tmp = join4(dir, `.baker-image-${randomBytes(8).toString("hex")}.tmp`);
   await writeFile4(tmp, data);
   await rename(tmp, absolute);
 }
@@ -17761,7 +17890,7 @@ Examples:
 });
 
 // src/version.ts
-import { readFileSync as readFileSync8 } from "fs";
+import { readFileSync as readFileSync9 } from "fs";
 function packageJsonUrl() {
   return new URL("../package.json", import.meta.url);
 }
@@ -17773,7 +17902,7 @@ function parsePackageVersion(raw) {
   throw new Error("Invalid CLI package.json: missing version");
 }
 function getCliVersion() {
-  return parsePackageVersion(readFileSync8(packageJsonUrl(), "utf8"));
+  return parsePackageVersion(readFileSync9(packageJsonUrl(), "utf8"));
 }
 
 // src/cli.ts