@koda-sl/baker-cli 0.543.0 → 0.544.0

package/dist/cite-G5PPVGTC.js

@@ -0,0 +1,191 @@
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-W4W3F3P7.js";
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  apiPost
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema
+} from "./chunk-WCIS4FZH.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-G5PPVGTC.js.map

package/dist/cite-G5PPVGTC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/cite.ts"],"sourcesContent":["import type {\n  ResearchCiteCheckRequest,\n  ResearchCiteCheckResponse,\n  ResearchCiteRequest,\n  ResearchCiteResponse,\n} from \"@baker/api/research-cite\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { repeatedValues } from \"../../lib/repeatedFlags.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { handleResearchError, type ResearchFix, writeResearchJson } from \"./output.ts\";\n\n/** A page behind a bot wall can take a while to clear, as with `research fetch`. */\nconst TIMEOUT_MS = 180_000;\n\n/** Past this, a fact about a competitor (price, plan, ownership) is worth re-reading before it ships. */\nexport const STALE_AFTER_DAYS = 14;\n\nregisterSchema({\n  command: \"research.cite\",\n  description:\n    \"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 — drop the quotation marks or label the line `Synthesis:`. `--check <evidenceId>` re-reads the page before you reuse a fact.\",\n  args: {\n    url: { type: \"string\", description: \"The page that says it\", required: false },\n    span: {\n      type: \"string\",\n      description: \"Exact words from the page (8-1000 chars). Repeat --span for several, up to 10\",\n      required: false,\n    },\n    check: {\n      type: \"string\",\n      description:\n        \"Re-read a cited page by its evidenceId and say whether the spans are still there, and how old the citation is\",\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Also return the final URL, page title, content hash and the page's own spelling of each span\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nconst FIELDS: Record<string, string> = {\n  evidenceId: \"Id of the recorded evidence — put it next to the claim, and pass it to --check before reusing the fact\",\n  url: \"The page as asked for\",\n  capturedAt: \"When the page was read and the spans checked\",\n  spans: \"Each span: found (word for word on the page) and, when found, the page's words around it\",\n};\n\nfunction quoted(text: string): string {\n  return `\"${text.length > 80 ? `${text.slice(0, 77)}…` : text}\"`;\n}\n\n/** The nudge after a cite: what to do with a span the page does not carry, and how to reuse one it does. */\nexport function citeHints(result: ResearchCiteResponse): string[] {\n  const missing = result.spans.filter((span) => !span.found);\n  const hints: string[] = [];\n  if (missing.length > 0) {\n    hints.push(\n      `Not on the page word for word: ${missing.map((span) => quoted(span.text)).join(\", \")}. ` +\n        \"Do not present these as quotes: drop the quotation marks and paraphrase with the link, or label the line `Synthesis:`. \" +\n        \"Never attribute them to a person. Carry on with the rest of the job.\",\n    );\n    if (result.truncated) {\n      hints.push(\n        `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.`,\n      );\n    }\n  }\n  if (missing.length < result.spans.length) {\n    hints.push(\n      `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}\\`.`,\n    );\n  }\n  return hints;\n}\n\n/** The nudge after a re-check: which spans went away and whether the citation is old. */\nexport function citeCheckHints(result: ResearchCiteCheckResponse): string[] {\n  const hints: string[] = [];\n  const gone = result.spans.filter((span) => span.wasFound && !span.found);\n  if (gone.length > 0 && result.truncated) {\n    hints.push(\n      `Not found this time: ${gone.map((span) => quoted(span.text)).join(\", \")} — 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)}\".`,\n    );\n  } else if (gone.length > 0) {\n    hints.push(\n      `No longer on the page: ${gone.map((span) => quoted(span.text)).join(\", \")}. The page changed since ${result.capturedAt.slice(0, 10)} — do not reuse these as current facts. Re-research them, or state them as \"as of ${result.capturedAt.slice(0, 10)}\".`,\n    );\n  } else if (result.ageDays >= STALE_AFTER_DAYS) {\n    hints.push(\n      `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.`,\n    );\n  }\n  return hints;\n}\n\nfunction citeView(result: ResearchCiteResponse, full: boolean) {\n  if (full) return result;\n  return {\n    evidenceId: result.evidenceId,\n    url: result.url,\n    capturedAt: result.capturedAt,\n    spans: result.spans.map(({ text, found, context }) => (context ? { text, found, context } : { text, found })),\n  };\n}\n\nfunction checkView(result: ResearchCiteCheckResponse, full: boolean) {\n  if (full) return result;\n  return {\n    evidenceId: result.evidenceId,\n    url: result.url,\n    capturedAt: result.capturedAt,\n    checkedAt: result.checkedAt,\n    ageDays: result.ageDays,\n    pageChanged: result.pageChanged,\n    ...(result.truncated ? { truncated: true } : {}),\n    spans: result.spans.map(({ text, found, wasFound }) => ({ text, found, wasFound })),\n  };\n}\n\n/** A failed read is one source of a larger job: name the gap and keep going. */\nfunction citeFix(code: string): ResearchFix {\n  if (code === \"VALIDATION_ERROR\" || code === \"BAD_REQUEST\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation:\n        'Pass the full page address (https://…) and at least one exact span of 8+ characters: baker research cite \"<url>\" \"<exact words>\" --span \"<more exact words>\".',\n    };\n  }\n  if (code === \"NOT_FOUND\") {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"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.\",\n    };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"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.\",\n  };\n}\n\nfunction failValidation(message: string): never {\n  writeResearchJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message, fix: citeFix(\"VALIDATION_ERROR\") } });\n  process.exit(1);\n}\n\nexport const citeCommand = defineCommand({\n  meta: {\n    name: \"cite\",\n    description: `Prove a quote-grade claim before it goes into Knowledge, a landing, an ad or a report.\n\nStart 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 — nothing else), and the evidence is recorded: when, where, a hash of the page and the words around each span.\n\nA 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:\\`.\n\nBefore 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.\n\nExamples:\n  baker research cite \"https://acme.com/pricing\" \"Plans start at $10 per month\"\n  baker research cite \"https://acme.com/about\" --span \"founded in 2014\" --span \"offices in Berlin and Madrid\"\n  baker research cite --check jd7f0m3k2x9y`,\n  },\n  args: {\n    url: { type: \"positional\", description: \"The page that says it\", required: false },\n    span: { type: \"string\", description: \"Exact words from the page; repeat for several\", required: false },\n    check: { type: \"string\", description: \"Re-check an evidenceId\", required: false },\n    full: { type: \"boolean\", description: \"Return every field\", required: false },\n  },\n  run: async ({ args, rawArgs }) => {\n    const full = Boolean(args.full);\n    const check = typeof args.check === \"string\" ? args.check.trim() : \"\";\n    try {\n      if (check) {\n        const body: ResearchCiteCheckRequest = { evidenceId: check };\n        const result = await apiPost<ResearchCiteCheckResponse>(\"/api/research/cite/check\", body, {\n          timeoutMs: TIMEOUT_MS,\n        });\n        writeResearchJson({ ok: true, data: checkView(result, full), hints: citeCheckHints(result) });\n        return;\n      }\n\n      const positionals = (Array.isArray(args._) ? args._ : []).filter(\n        (word): word is string => typeof word === \"string\" && word.trim().length > 0,\n      );\n      const [url, ...positionalSpans] = positionals;\n      if (!url) failValidation(\"A page URL is required (or --check <evidenceId>).\");\n      const spans = [...positionalSpans, ...repeatedValues(rawArgs, \"span\", args.span)];\n      if (spans.length === 0) failValidation(\"At least one exact span is required.\");\n\n      const body: ResearchCiteRequest = { url, spans };\n      const result = await apiPost<ResearchCiteResponse>(\"/api/research/cite\", body, { timeoutMs: TIMEOUT_MS });\n      writeResearchJson({ ok: true, data: citeView(result, full), fields: FIELDS, hints: citeHints(result) });\n    } catch (err) {\n      handleResearchError(err, citeFix);\n    }\n  },\n});\n"],"mappings":"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","names":["body","result"]}

package/dist/claim-XWJJMUON.js

@@ -0,0 +1,200 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-CMXG4X3S.js";
+import "./chunk-NFXW6C6I.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-TI4UL56R.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import {
+  requireChatId
+} from "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.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-XWJJMUON.js.map

package/dist/cli.js

@@ -3,20 +3,20 @@ import {
   cacheFlagForCommand,
   cacheFlagForParser,
   normalizeCacheFlag
-} from "./chunk-3PG7O3ZW.js";
+} from "./chunk-FPTEBOB5.js";
 import {
   agentProfile,
   applyAgentProfile,
   loadCommands
-} from "./chunk-6KWPAPFL.js";
+} from "./chunk-GEQUWPAX.js";
 import {
   installExitRecord,
   installStreamTaps,
   logInvocation
-} from "./chunk-ELAYD7O3.js";
+} from "./chunk-SVUFNCOE.js";
 import {
   setTargetCompany
-} from "./chunk-LBIF6FJY.js";
+} from "./chunk-E54435XT.js";
 import {
   asksForEnvelopeAlone,
   commandFor,
@@ -40,7 +40,7 @@ import {
   withHint,
   withOutput,
   writeJson
-} from "./chunk-TRXGJZDL.js";
+} from "./chunk-WCIS4FZH.js";
 import "./chunk-YQSBHWOI.js";
 
 // src/cli.ts
@@ -460,46 +460,46 @@ File: --out <file> writes the whole envelope to a file and prints a summary (fil
 Introspection: Run 'baker schema <command>' to inspect argument schemas.`
   },
   subCommands: {
-    capabilities: () => import("./capabilities-Y2UYDZZO.js").then((m) => m.capabilitiesCommand),
-    actions: () => import("./actions-7ELREPKR.js").then((m) => m.actionsCommand),
-    "scheduled-agents": () => import("./scheduled-agents-2NTFBABN.js").then((m) => m.scheduledAgentsCommand),
-    ads: () => import("./ads-CIWS4COT.js").then((m) => m.adsCommand),
-    brand: () => import("./brand-YCYKIUIL.js").then((m) => m.brandCommand),
-    analytics: () => import("./analytics-TBEIK33Y.js").then((m) => m.analyticsCommand),
-    experiment: () => import("./experiment-2TTMKPVC.js").then((m) => m.experimentCommand),
-    ga4: () => import("./ga4-WIOBF5HW.js").then((m) => m.ga4Command),
-    gsc: () => import("./gsc-KDE2DTH2.js").then((m) => m.gscCommand),
-    research: () => import("./research-FISSUVIK.js").then((m) => m.researchCommand),
-    decide: () => import("./decide-MPNAZFAK.js").then((m) => m.decideCommand),
-    knowledge: () => import("./knowledge-5VEMAHG7.js").then((m) => m.knowledgeCommand),
-    creatives: () => import("./creatives-MXMQDNL6.js").then((m) => m.creativesCommand),
-    flows: () => import("./flows-P5T4LNJ2.js").then((m) => m.flowsCommand),
-    funnel: () => import("./funnel-D6YXU7C4.js").then((m) => m.funnelCommand),
-    images: () => import("./images-55KBTRVO.js").then((m) => m.imagesCommand),
-    studio: () => import("./studio-4QOFG7MQ.js").then((m) => m.studioCommand),
-    avatars: () => import("./avatars-H5RIENFM.js").then((m) => m.avatarsCommand),
-    landing: () => import("./landing-DZLICA3P.js").then((m) => m.landingCommand),
-    videos: () => import("./videos-OVVH4LC2.js").then((m) => m.videosCommand),
-    testimonials: () => import("./testimonials-IEJ24MH7.js").then((m) => m.testimonialsCommand),
-    canvas: () => import("./canvas-FWG5JGG4.js").then((m) => m.canvasCommand),
-    tags: () => import("./tags-CBINFGAN.js").then((m) => m.tagsCommand),
-    "tag-manager": () => import("./tag-manager-KWITWX6Y.js").then((m) => m.tagManagerCommand),
-    chats: () => import("./chats-A3XSSBJF.js").then((m) => m.chatsCommand),
-    history: () => import("./history-BRWYSJQL.js").then((m) => m.historyCommand),
-    credentials: () => import("./credentials-CMOO7W6D.js").then((m) => m.credentialsCommand),
-    hubspot: () => import("./hubspot-YEZGTOM2.js").then((m) => m.hubspotCommand),
-    activecampaign: () => import("./activecampaign-VOKDHWP7.js").then((m) => m.activecampaignCommand),
-    accounts: () => import("./accounts-CZOZDD5I.js").then((m) => m.accountsCommand),
-    shopify: () => import("./shopify-MODNP6LT.js").then((m) => m.shopifyCommand),
-    "winning-ads": () => import("./winning-ads-HIP6PWPL.js").then((m) => m.winningAdsCommand),
-    "media-sources": () => import("./media-sources-NTZRJGFU.js").then((m) => m.mediaSourcesCommand),
-    posts: () => import("./posts-YPW4NHWM.js").then((m) => m.postsCommand),
-    site: () => import("./site-5K73B2MI.js").then((m) => m.siteCommand),
-    "lead-routes": () => import("./lead-routes-Q2T3RQXN.js").then((m) => m.leadRoutesCommand),
-    mcp: () => import("./mcp-VRFT3QJW.js").then((m) => m.mcpCommand),
-    "setup-links": () => import("./setup-links-SJVDPNOF.js").then((m) => m.setupLinksCommand),
-    organization: () => import("./organization-TO2V7AWX.js").then((m) => m.organizationCommand),
-    schema: () => import("./schema-BDZA64GZ.js").then((m) => m.schemaCommand)
+    capabilities: () => import("./capabilities-VQF723CB.js").then((m) => m.capabilitiesCommand),
+    actions: () => import("./actions-SYRCIDHV.js").then((m) => m.actionsCommand),
+    "scheduled-agents": () => import("./scheduled-agents-35PY445V.js").then((m) => m.scheduledAgentsCommand),
+    ads: () => import("./ads-I6WMPAO3.js").then((m) => m.adsCommand),
+    brand: () => import("./brand-KTM3OQNE.js").then((m) => m.brandCommand),
+    analytics: () => import("./analytics-AWBWIVXW.js").then((m) => m.analyticsCommand),
+    experiment: () => import("./experiment-3D4HJ7HL.js").then((m) => m.experimentCommand),
+    ga4: () => import("./ga4-SBHUQKGK.js").then((m) => m.ga4Command),
+    gsc: () => import("./gsc-EQYYXMSJ.js").then((m) => m.gscCommand),
+    research: () => import("./research-GTEAD4OK.js").then((m) => m.researchCommand),
+    decide: () => import("./decide-65GLJMTU.js").then((m) => m.decideCommand),
+    knowledge: () => import("./knowledge-LQXY6UIX.js").then((m) => m.knowledgeCommand),
+    creatives: () => import("./creatives-PWUBAVOB.js").then((m) => m.creativesCommand),
+    flows: () => import("./flows-6654JFGC.js").then((m) => m.flowsCommand),
+    funnel: () => import("./funnel-ITXHCKXM.js").then((m) => m.funnelCommand),
+    images: () => import("./images-WLAJPXFL.js").then((m) => m.imagesCommand),
+    studio: () => import("./studio-6ZXUKA4G.js").then((m) => m.studioCommand),
+    avatars: () => import("./avatars-LUCFVVCN.js").then((m) => m.avatarsCommand),
+    landing: () => import("./landing-ILHRRFYD.js").then((m) => m.landingCommand),
+    videos: () => import("./videos-OGMX2BDQ.js").then((m) => m.videosCommand),
+    testimonials: () => import("./testimonials-H6SAGYMM.js").then((m) => m.testimonialsCommand),
+    canvas: () => import("./canvas-2DIDJAD4.js").then((m) => m.canvasCommand),
+    tags: () => import("./tags-BYZCEK5V.js").then((m) => m.tagsCommand),
+    "tag-manager": () => import("./tag-manager-5ORFHLM4.js").then((m) => m.tagManagerCommand),
+    chats: () => import("./chats-BWMB3I6F.js").then((m) => m.chatsCommand),
+    history: () => import("./history-F765U4J7.js").then((m) => m.historyCommand),
+    credentials: () => import("./credentials-45X7PJJK.js").then((m) => m.credentialsCommand),
+    hubspot: () => import("./hubspot-VJOE2XCP.js").then((m) => m.hubspotCommand),
+    activecampaign: () => import("./activecampaign-NASTXUEK.js").then((m) => m.activecampaignCommand),
+    accounts: () => import("./accounts-RFJ4MENH.js").then((m) => m.accountsCommand),
+    shopify: () => import("./shopify-RALHX5OB.js").then((m) => m.shopifyCommand),
+    "winning-ads": () => import("./winning-ads-J3WR3ENK.js").then((m) => m.winningAdsCommand),
+    "media-sources": () => import("./media-sources-JFLZPZAO.js").then((m) => m.mediaSourcesCommand),
+    posts: () => import("./posts-FV62HSKG.js").then((m) => m.postsCommand),
+    site: () => import("./site-WKS57PJL.js").then((m) => m.siteCommand),
+    "lead-routes": () => import("./lead-routes-HBAMCZI4.js").then((m) => m.leadRoutesCommand),
+    mcp: () => import("./mcp-GS7AO7K5.js").then((m) => m.mcpCommand),
+    "setup-links": () => import("./setup-links-BI6GPN5F.js").then((m) => m.setupLinksCommand),
+    organization: () => import("./organization-ZACAD7FF.js").then((m) => m.organizationCommand),
+    schema: () => import("./schema-NSXMRNWM.js").then((m) => m.schemaCommand)
   }
 });
 

package/dist/client-6MXJPWFS.js

@@ -0,0 +1,19 @@
+import {
+  ApiError,
+  apiGet,
+  apiGetWithHeaders,
+  apiPost,
+  validateConvexId
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  ApiError,
+  apiGet,
+  apiGetWithHeaders,
+  apiPost,
+  validateConvexId
+};
+//# sourceMappingURL=client-6MXJPWFS.js.map

package/dist/code-TIM5S232.js

@@ -0,0 +1,76 @@
+import {
+  INSPIRATION_HINTS,
+  fidelityHint,
+  reportError
+} from "./chunk-464UOCP6.js";
+import {
+  apiGet
+} from "./chunk-B2OHCWYB.js";
+import "./chunk-SVUFNCOE.js";
+import "./chunk-E54435XT.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WCIS4FZH.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/code.ts
+import { mkdir, writeFile } from "fs/promises";
+import path from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "landing.inspiration.code",
+  description: "Write a reference section's standalone HTML+CSS to .baker/inspiration/<id>/ so you can read how it is built. Reference only \u2014 the structure is the lesson, the words are not yours to reuse.",
+  args: {
+    id: { type: "string", description: "Section id from search", required: true },
+    full: { type: "boolean", description: "Print the markup inline as well as writing it", required: false }
+  }
+});
+var codeCommand = defineCommand({
+  meta: {
+    name: "code",
+    description: "Write one reference section's standalone markup to disk. Example: baker landing inspiration code k57abc\u2026 \u2014 read it for structure, then build your own."
+  },
+  args: {
+    id: { type: "positional", description: "Section id from search", required: true },
+    full: { type: "boolean", description: "Also print the markup inline", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id;
+      const data = await apiGet("/api/landing-inspiration/section-code", { id });
+      const dir = path.join(process.cwd(), ".baker", "inspiration", id);
+      await mkdir(dir, { recursive: true });
+      const file = path.join(dir, "section.html");
+      await writeFile(file, data.html);
+      const hints = [INSPIRATION_HINTS.structureNotCopy, INSPIRATION_HINTS.adapt];
+      const fidelity = fidelityHint(data.fidelity);
+      if (fidelity) hints.push(fidelity);
+      if (data.fidelityNote) hints.push(data.fidelityNote);
+      writeJson({
+        ok: true,
+        data: {
+          id,
+          file: path.relative(process.cwd(), file),
+          bytes: data.html.length,
+          fidelity: data.fidelity,
+          reproduction_notes: data.reproductionNotes,
+          adaptation_notes: data.adaptationNotes,
+          source_url: data.sourceUrl,
+          // Behind --full with the markup it belongs to. Up to 60 custom-property
+          // *names*, one per line, was over half the default response — and the
+          // file on disk already has them, next to the values that give them
+          // meaning. A list of variable names on its own decides nothing.
+          ...args.full ? { css_custom_properties: data.cssCustomProperties, html: data.html } : {}
+        },
+        hints
+      });
+    } catch (error) {
+      reportError(error);
+    }
+  }
+});
+export {
+  codeCommand
+};
+//# sourceMappingURL=code-TIM5S232.js.map