@koda-sl/baker-cli 0.571.0 → 0.572.0-dev.61ba69c66

package/dist/chunk-YT3S2XFG.js

@@ -0,0 +1,84 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-UUDWZIDC.js";
+
+// src/commands/videos/api.ts
+import { readFile } from "fs/promises";
+import { basename, extname } from "path";
+var videoProcessingTimeoutMs = 18e4;
+var videoReadyPollIntervalMs = 3e3;
+var mimeMap = {
+  ".mp4": "video/mp4",
+  ".mov": "video/quicktime",
+  ".webm": "video/webm",
+  ".avi": "video/x-msvideo",
+  ".mkv": "video/x-matroska"
+};
+var defaultVideoApiDeps = {
+  readFile,
+  post: apiPost,
+  get: apiGet,
+  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+  putFile: async (url, contentType, body) => {
+    const response = await fetch(url, { method: "PUT", headers: { "Content-Type": contentType }, body });
+    if (!response.ok) {
+      throw new ApiError("INTERNAL_ERROR", `Mux upload failed: HTTP ${response.status} ${response.statusText}`);
+    }
+  }
+};
+function isVideoFile(filePath) {
+  return mimeMap[extname(filePath).toLowerCase()] !== void 0;
+}
+function detectVideoContentType(filePath, opts = {}) {
+  const ext = extname(filePath).toLowerCase();
+  const contentType = mimeMap[ext];
+  if (!contentType || opts.allowedContentTypes && !opts.allowedContentTypes.includes(contentType)) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      opts.unsupportedMessage ?? `Cannot detect content type for extension "${ext}". Use --content-type.`
+    );
+  }
+  return contentType;
+}
+async function uploadLocalVideo(args, deps = defaultVideoApiDeps) {
+  const { uploadUrl, videoId } = await deps.post("/api/videos/upload", {
+    originalFilename: basename(args.file),
+    descriptionContext: args.descriptionContext
+  });
+  await deps.putFile(uploadUrl, args.contentType, await deps.readFile(args.file));
+  return { videoId };
+}
+var PLAYABLE_STATUSES = /* @__PURE__ */ new Set(["uploaded", "processing", "ready"]);
+async function waitForPlayableVideo(deps, videoId, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? videoProcessingTimeoutMs;
+  const pollIntervalMs = opts.pollIntervalMs ?? videoReadyPollIntervalMs;
+  const deadline = Date.now() + timeoutMs;
+  let lastStatus = "unknown";
+  while (Date.now() <= deadline) {
+    const video = await deps.get("/api/videos/get", { id: videoId });
+    lastStatus = video.status;
+    if (video.muxPlaybackId && PLAYABLE_STATUSES.has(video.status)) {
+      return video;
+    }
+    if (video.status === "error") {
+      throw new ApiError(
+        "INTERNAL_ERROR",
+        "The video library could not process this file. Export it again as an MP4 (H.264) and retry."
+      );
+    }
+    await deps.sleep(pollIntervalMs);
+  }
+  throw new ApiError("TIMEOUT", `Video was not playable before timeout; last status: ${lastStatus}`);
+}
+
+export {
+  videoProcessingTimeoutMs,
+  defaultVideoApiDeps,
+  isVideoFile,
+  detectVideoContentType,
+  uploadLocalVideo,
+  waitForPlayableVideo
+};
+//# sourceMappingURL=chunk-YT3S2XFG.js.map

package/dist/chunk-ZPCZ4XDB.js

@@ -0,0 +1,148 @@
+import {
+  RULES_DIR,
+  SAME_WORDS,
+  frontmatterOf,
+  parseIdea,
+  parseInsight
+} from "./chunk-KPVZ2CZA.js";
+import {
+  rememberedJev
+} from "./chunk-VCDFBFPT.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-Q4O7ICAK.js";
+
+// src/commands/creatives/ideas-judgments.ts
+var STATISTIC_QUESTION = `\`quote\` was filed as something a customer said. Is it instead a statistic about a group of people, a share or a figure from a survey, a study or an article ("39% of UK homeowners say\u2026", "a quarter of buyers\u2026", "1 in 3 owners\u2026"), rather than one person's own words about their own experience? A person giving their own number ("My bill dropped 40%") is their own words. The quote may be in any language.`;
+var STATISTIC_HELD = 0.65;
+var SAME_MESSAGE_QUESTION = `\`a\` and \`b\` are the messages of two ads. Do they make the same core promise to the viewer (the same benefit, the same reason to act), even when one adds a detail or a few words, says it in other words, or is in another language? Two messages that promise different things about the same product are not the same.`;
+var SAME_MESSAGE_HELD = 0.42;
+async function withStatisticsRead(insights, ask) {
+  const observed = insights.filter((i) => i.status === "observed");
+  if (observed.length === 0) return [...insights];
+  const answers = await ask(observed.map((i) => ({ instructions: { quote: i.quote, question: STATISTIC_QUESTION } })));
+  if (answers === null) return [...insights];
+  const statistics = new Set(observed.filter((_, i) => (answers[i] ?? 0) >= STATISTIC_HELD).map((i) => i.id));
+  return insights.map((i) => statistics.has(i.id) ? { ...i, status: "interpreted" } : i);
+}
+async function sameMessageRead(ideas, ask) {
+  const failed = ideas.filter((i) => i.status === "failed");
+  const pairs = failed.flatMap(
+    (f) => ideas.filter((i) => i.id !== f.id && !SAME_WORDS(i.message, f.message)).map((i) => [f.message, i.message])
+  );
+  if (pairs.length === 0) return SAME_WORDS;
+  const answers = await ask(pairs.map(([a, b]) => ({ instructions: { a, b, question: SAME_MESSAGE_QUESTION } })));
+  if (answers === null) return SAME_WORDS;
+  const same = new Set(
+    pairs.filter((_, i) => (answers[i] ?? 0) >= SAME_MESSAGE_HELD).map(([a, b]) => `${a}\0${b}`)
+  );
+  return (a, b) => SAME_WORDS(a, b) || same.has(`${a}\0${b}`) || same.has(`${b}\0${a}`);
+}
+
+// src/commands/creatives/ideas-workspace.ts
+import { readdir, readFile } from "fs/promises";
+import path from "path";
+var IDEAS_DIR = path.join("src", "creatives", "_ideas");
+var INSIGHTS_DIR = path.join("src", "content", "insights");
+async function markdownFiles(dir, recursive = false) {
+  const entries = await readdir(dir, { recursive }).catch(() => []);
+  return entries.filter((f) => f.endsWith(".md")).sort();
+}
+var idOf = (file) => file.replace(/\\/g, "/").replace(/\.md$/, "");
+function workspaceIdeasJudge(root) {
+  const cacheDir = path.join(root, "canvas", ".cache");
+  const spent = [];
+  return {
+    ask: rememberedJev(path.join(cacheDir, "ideas-answers.json"), (u) => spent.push(u)),
+    done: () => holdUnbilledSpend(cacheDir, spent.splice(0)).catch(() => void 0)
+  };
+}
+async function readInsights(root, opts = {}) {
+  const dir = path.join(root, INSIGHTS_DIR);
+  const insights = [];
+  for (const file of await markdownFiles(dir, true)) {
+    const insight = parseInsight(idOf(file), await readFile(path.join(dir, file), "utf8").catch(() => ""));
+    if (insight) insights.push(insight);
+  }
+  if (opts.ask) return withStatisticsRead(insights, opts.ask);
+  const judge = workspaceIdeasJudge(root);
+  const read = await withStatisticsRead(insights, judge.ask);
+  await judge.done();
+  return read;
+}
+async function readIdeas(root) {
+  const dir = path.join(root, IDEAS_DIR);
+  const ideas = [];
+  const unreadable = [];
+  for (const file of await markdownFiles(dir)) {
+    const id = idOf(file);
+    const parsed = parseIdea(id, await readFile(path.join(dir, file), "utf8").catch(() => ""));
+    if (parsed.idea) ideas.push(parsed.idea);
+    else unreadable.push({ id, problems: parsed.problems });
+  }
+  return { ideas, unreadable };
+}
+async function readPersonaIds(root) {
+  return (await markdownFiles(path.join(root, "src", "content", "personas"), true)).map(idOf);
+}
+var MAX_KNOWLEDGE_CHARS = 2e5;
+async function readKnowledgeCorpus(root) {
+  const parts = [];
+  const company = await readFile(path.join(root, "COMPANY.md"), "utf8").catch(() => "");
+  if (company) parts.push(company);
+  const content = path.join(root, "src", "content");
+  const insights = path.relative(content, path.join(root, INSIGHTS_DIR));
+  const rules = path.relative(content, path.join(root, RULES_DIR));
+  const files = (await markdownFiles(content, true)).filter((f) => {
+    const file = f.replace(/\\/g, "/");
+    return !file.startsWith(`${insights}/`) && !file.startsWith(`${rules}/`);
+  });
+  for (const file of files) {
+    parts.push(await readFile(path.join(content, file), "utf8").catch(() => ""));
+    if (parts.join("").length > MAX_KNOWLEDGE_CHARS) break;
+  }
+  return parts.join("\n").slice(0, MAX_KNOWLEDGE_CHARS);
+}
+async function readCreativeRecords(root) {
+  const dir = path.join(root, "src", "creatives");
+  const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+  const records = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory() || entry.name.startsWith("_")) continue;
+    const raw = await readFile(path.join(dir, entry.name, "_definition.md"), "utf8").catch(() => null);
+    if (raw === null) continue;
+    const fm = frontmatterOf(raw) ?? {};
+    const pick = (key) => typeof fm[key] === "string" && fm[key] ? { [key]: fm[key] } : {};
+    records.push({
+      slug: entry.name,
+      ...pick("status"),
+      ...pick("idea"),
+      ...pick("awareness"),
+      ...pick("angle"),
+      ...pick("kind")
+    });
+  }
+  return records;
+}
+var SHOWN_STATUSES = /* @__PURE__ */ new Set(["rendered", "published"]);
+function coverageOf(ideas, creatives) {
+  const live = ideas.filter((i) => i.status === "built" || i.status === "testing" || i.status === "winner");
+  const awareness = new Set(live.map((i) => i.awareness));
+  for (const creative of creatives) {
+    if (creative.awareness && SHOWN_STATUSES.has(creative.status ?? "")) awareness.add(creative.awareness);
+  }
+  return { coveredAwareness: [...awareness].sort(), closersLive: live.filter((i) => i.job === "closer").length };
+}
+
+export {
+  sameMessageRead,
+  IDEAS_DIR,
+  workspaceIdeasJudge,
+  readInsights,
+  readIdeas,
+  readPersonaIds,
+  readKnowledgeCorpus,
+  readCreativeRecords,
+  coverageOf
+};
+//# sourceMappingURL=chunk-ZPCZ4XDB.js.map

package/dist/cite-2ZJG3FBV.js

@@ -0,0 +1,191 @@
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-C3RZNVLM.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  apiPost
+} from "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import "./chunk-6LUDG5AB.js";
+import {
+  registerSchema
+} from "./chunk-6V4UAC5I.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/cite.ts
+import { defineCommand } from "citty";
+var TIMEOUT_MS = 18e4;
+var STALE_AFTER_DAYS = 14;
+registerSchema({
+  command: "research.cite",
+  description: "Prove a quote-grade claim: read the page, check each span is on it word for word, and record the evidence (url, time, page hash, the span in context). Not-found spans come back found:false \u2014 drop the quotation marks or label the line `Synthesis:`. `--check <evidenceId>` re-reads the page before you reuse a fact.",
+  args: {
+    url: { type: "string", description: "The page that says it", required: false },
+    span: {
+      type: "string",
+      description: "Exact words from the page (8-1000 chars). Repeat --span for several, up to 10",
+      required: false
+    },
+    check: {
+      type: "string",
+      description: "Re-read a cited page by its evidenceId and say whether the spans are still there, and how old the citation is",
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Also return the final URL, page title, content hash and the page's own spelling of each span",
+      required: false,
+      default: false
+    }
+  }
+});
+var FIELDS = {
+  evidenceId: "Id of the recorded evidence \u2014 put it next to the claim, and pass it to --check before reusing the fact",
+  url: "The page as asked for",
+  capturedAt: "When the page was read and the spans checked",
+  spans: "Each span: found (word for word on the page) and, when found, the page's words around it"
+};
+function quoted(text) {
+  return `"${text.length > 80 ? `${text.slice(0, 77)}\u2026` : text}"`;
+}
+function citeHints(result) {
+  const missing = result.spans.filter((span) => !span.found);
+  const hints = [];
+  if (missing.length > 0) {
+    hints.push(
+      `Not on the page word for word: ${missing.map((span) => quoted(span.text)).join(", ")}. Do not present these as quotes: drop the quotation marks and paraphrase with the link, or label the line \`Synthesis:\`. Never attribute them to a person. Carry on with the rest of the job.`
+    );
+    if (result.truncated) {
+      hints.push(
+        `The page was cut at ${result.contentChars} characters, so a span further down reads as not found. Cite a deeper URL (the section's own page) if there is one.`
+      );
+    }
+  }
+  if (missing.length < result.spans.length) {
+    hints.push(
+      `Write the found spans as quotes with the link and the capture date, and keep evidenceId ${result.evidenceId} beside the claim. Before reusing the fact in a later deliverable, run \`baker research cite --check ${result.evidenceId}\`.`
+    );
+  }
+  return hints;
+}
+function citeCheckHints(result) {
+  const hints = [];
+  const gone = result.spans.filter((span) => span.wasFound && !span.found);
+  if (gone.length > 0 && result.truncated) {
+    hints.push(
+      `Not found this time: ${gone.map((span) => quoted(span.text)).join(", ")} \u2014 but the page was cut before its end, so they may sit past the cut rather than be gone. Re-cite them on the section's own URL before reusing them, or state them as "as of ${result.capturedAt.slice(0, 10)}".`
+    );
+  } else if (gone.length > 0) {
+    hints.push(
+      `No longer on the page: ${gone.map((span) => quoted(span.text)).join(", ")}. The page changed since ${result.capturedAt.slice(0, 10)} \u2014 do not reuse these as current facts. Re-research them, or state them as "as of ${result.capturedAt.slice(0, 10)}".`
+    );
+  } else if (result.ageDays >= STALE_AFTER_DAYS) {
+    hints.push(
+      `Still on the page, but first cited ${result.ageDays} days ago. Prices, plans and ownership move: cite again (\`baker research cite\`) so the deliverable carries today's date.`
+    );
+  }
+  return hints;
+}
+function citeView(result, full) {
+  if (full) return result;
+  return {
+    evidenceId: result.evidenceId,
+    url: result.url,
+    capturedAt: result.capturedAt,
+    spans: result.spans.map(({ text, found, context }) => context ? { text, found, context } : { text, found })
+  };
+}
+function checkView(result, full) {
+  if (full) return result;
+  return {
+    evidenceId: result.evidenceId,
+    url: result.url,
+    capturedAt: result.capturedAt,
+    checkedAt: result.checkedAt,
+    ageDays: result.ageDays,
+    pageChanged: result.pageChanged,
+    ...result.truncated ? { truncated: true } : {},
+    spans: result.spans.map(({ text, found, wasFound }) => ({ text, found, wasFound }))
+  };
+}
+function citeFix(code) {
+  if (code === "VALIDATION_ERROR" || code === "BAD_REQUEST") {
+    return {
+      action: "retry_with_changes",
+      explanation: 'Pass the full page address (https://\u2026) and at least one exact span of 8+ characters: baker research cite "<url>" "<exact words>" --span "<more exact words>".'
+    };
+  }
+  if (code === "NOT_FOUND") {
+    return {
+      action: "continue_without",
+      explanation: "The page or the evidence id does not exist. Do not quote from it: drop the quotation marks or label the line `Synthesis:`, and carry on."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "The page could not be read, so nothing on it is verified. Do not present the claim as a quote: drop the quotation marks or label the line `Synthesis:`, name the page as a gap, and finish the rest of the job."
+  };
+}
+function failValidation(message) {
+  writeResearchJson({ ok: false, error: { code: "VALIDATION_ERROR", message, fix: citeFix("VALIDATION_ERROR") } });
+  process.exit(1);
+}
+var citeCommand = defineCommand({
+  meta: {
+    name: "cite",
+    description: `Prove a quote-grade claim before it goes into Knowledge, a landing, an ad or a report.
+
+Start here: pass the page and the exact words you want to quote. The page is read fresh, each span is checked word for word (case, spacing, curly quotes and dashes forgiven \u2014 nothing else), and the evidence is recorded: when, where, a hash of the page and the words around each span.
+
+A span that is not on the page comes back found:false. Do not quote it: drop the quotation marks and paraphrase with the link, or label it \`Synthesis:\`.
+
+Before reusing a cited fact later, re-check it: \`--check <evidenceId>\` re-reads the page and says whether the spans are still there and how old the citation is.
+
+Examples:
+  baker research cite "https://acme.com/pricing" "Plans start at $10 per month"
+  baker research cite "https://acme.com/about" --span "founded in 2014" --span "offices in Berlin and Madrid"
+  baker research cite --check jd7f0m3k2x9y`
+  },
+  args: {
+    url: { type: "positional", description: "The page that says it", required: false },
+    span: { type: "string", description: "Exact words from the page; repeat for several", required: false },
+    check: { type: "string", description: "Re-check an evidenceId", required: false },
+    full: { type: "boolean", description: "Return every field", required: false }
+  },
+  run: async ({ args, rawArgs }) => {
+    const full = Boolean(args.full);
+    const check = typeof args.check === "string" ? args.check.trim() : "";
+    try {
+      if (check) {
+        const body2 = { evidenceId: check };
+        const result2 = await apiPost("/api/research/cite/check", body2, {
+          timeoutMs: TIMEOUT_MS
+        });
+        writeResearchJson({ ok: true, data: checkView(result2, full), hints: citeCheckHints(result2) });
+        return;
+      }
+      const positionals = (Array.isArray(args._) ? args._ : []).filter(
+        (word) => typeof word === "string" && word.trim().length > 0
+      );
+      const [url, ...positionalSpans] = positionals;
+      if (!url) failValidation("A page URL is required (or --check <evidenceId>).");
+      const spans = [...positionalSpans, ...repeatedValues(rawArgs, "span", args.span)];
+      if (spans.length === 0) failValidation("At least one exact span is required.");
+      const body = { url, spans };
+      const result = await apiPost("/api/research/cite", body, { timeoutMs: TIMEOUT_MS });
+      writeResearchJson({ ok: true, data: citeView(result, full), fields: FIELDS, hints: citeHints(result) });
+    } catch (err) {
+      handleResearchError(err, citeFix);
+    }
+  }
+});
+export {
+  STALE_AFTER_DAYS,
+  citeCheckHints,
+  citeCommand,
+  citeHints
+};
+//# sourceMappingURL=cite-2ZJG3FBV.js.map

package/dist/claim-IGU5W4CT.js

@@ -0,0 +1,200 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-6IL7JFX5.js";
+import "./chunk-YOHGEF2N.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-IMS53EQU.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import {
+  requireChatId
+} from "./chunk-6LUDG5AB.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-6V4UAC5I.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-IGU5W4CT.js.map