@koda-sl/baker-cli 0.466.0 → 0.467.0

package/dist/list-LYRCC67M.js

@@ -0,0 +1,303 @@
+import {
+  ACTIONS_LIST_DEFAULT_LIMIT,
+  buildListHints,
+  failApi
+} from "./chunk-RFJ3S47F.js";
+import "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import {
+  getEnv
+} from "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/list.ts
+import { defineCommand } from "citty";
+import { Lexer } from "marked";
+registerSchema({
+  command: "actions.list",
+  description: 'List actions for the current company. Compact by default: a bucketed Task is its id and name (plus its blockers, holder or staged change); a flat row (--search, --bucketed=false) adds status, priority, tags and a one-line `summary` of its description. Checking whether a Task already exists? --search "<words>" returns the matches with their summaries. --full prints whole descriptions (or `baker actions get <id>` for one Task). Default: pre-bucketed (claimable/myClaims/blocked/claimedByOthers/completed/discarded), each bucket ordered do-first (blockers before blocked, then highest-leverage). The bucketed view reads the whole open backlog, so nothing pending is ever hidden from it. Set --bucketed=false for a flat list filterable by --status, orderable by --sort, and windowed by --limit. Looking for one Task by name? --search "conversion goal" --output md returns only the matching Tasks instead of the whole backlog.',
+  args: {
+    search: {
+      type: "string",
+      description: 'Find Tasks by words in their name, description or tags, searched on the server (e.g. --search "conversion goal"). Returns a flat list, best match first; by default it covers pending, in-progress and completed Tasks. Add --status to search one status instead, including discarded Tasks (--status discarded). Implies --bucketed=false.',
+      required: false
+    },
+    bucketed: {
+      type: "boolean",
+      description: "Pre-bucket the results based on the current chat (default: true)",
+      required: false,
+      default: true
+    },
+    status: {
+      type: "string",
+      description: "Filter by status (only with --bucketed=false): pending|in_progress|completed|discarded",
+      required: false
+    },
+    sort: {
+      type: "string",
+      description: "Order a flat list (only with --bucketed=false): priority (do-first: blockers before blocked, then highest-leverage) | recent. Default: priority.",
+      required: false
+    },
+    limit: {
+      type: "string",
+      description: `How many Tasks a flat list reads, newest first (only with --bucketed=false). Default: ${ACTIONS_LIST_DEFAULT_LIMIT}. When the read comes back full, hints[] says so \u2014 raise --limit to reach older Tasks.`,
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Print every Task's whole description and full record instead of the compact row. Large on a real backlog \u2014 prefer --search, or `baker actions get <id>` for one Task.",
+      required: false,
+      default: false
+    },
+    output: { type: "string", description: "Output format: json|md. Default: json", required: false }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List actions, one short row per Task (id and name; --search rows add a one-line summary). Default: bucketed view (claimable, myClaims, blocked, claimedByOthers). Use --bucketed=false for raw filter by --status, --search <text> to find Tasks by name, --full for whole descriptions."
+  },
+  args: {
+    search: { type: "string", description: "Find Tasks by words in name/description/tags", required: false },
+    bucketed: { type: "boolean", description: "Pre-bucket by chat", required: false, default: true },
+    status: { type: "string", description: "Status filter (raw mode)", required: false },
+    sort: { type: "string", description: "Order (raw mode): priority|recent", required: false },
+    limit: { type: "string", description: "How many Tasks to read (raw mode)", required: false },
+    full: {
+      type: "boolean",
+      description: "Whole descriptions and full records",
+      required: false,
+      default: false
+    },
+    output: { type: "string", description: "Output format: json|md", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = buildListRequest(args, getEnv().BAKER_CHAT_ID);
+      const response = await apiPost("/api/actions/list", body);
+      const hints = body.bucketed === false && body.limit !== void 0 && response.ok && Array.isArray(response.data) ? buildListHints({ returned: response.data.length, limit: body.limit }) : [];
+      if (args.output === "md" && response.ok) {
+        process.stdout.write(renderMarkdown(response.data, hints, { full: args.full === true }));
+        return;
+      }
+      const compact = !args.full && response.ok;
+      const shaped = compact ? { ...response, data: compactListData(response.data) } : response;
+      const envelope = hints.length > 0 ? { ...shaped, hints } : shaped;
+      if (compact) {
+        process.stdout.write(`${JSON.stringify(envelope)}
+`);
+        return;
+      }
+      writeJson(envelope);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+function buildListRequest(args, chatId) {
+  const q = args.search?.trim();
+  if (args.bucketed !== false && !q) {
+    return chatId ? { bucketed: true, chatId } : { bucketed: true };
+  }
+  const parsedLimit = args.limit === void 0 ? Number.NaN : Number.parseInt(String(args.limit), 10);
+  const body = {
+    bucketed: false,
+    // Default to do-first ordering so the flat list matches its documented
+    // contract; only "recent" opts out. A search keeps relevance order.
+    sort: args.sort === "recent" ? "recent" : "priority",
+    limit: Number.isFinite(parsedLimit) && parsedLimit > 0 ? parsedLimit : ACTIONS_LIST_DEFAULT_LIMIT
+  };
+  if (q) {
+    body.q = q;
+  }
+  if (args.status) {
+    body.status = args.status;
+  }
+  return body;
+}
+var SUMMARY_MAX_CHARS = 100;
+function plainText(tokens) {
+  return tokens.map((token) => {
+    if (token.type === "image" || token.type === "html") {
+      return "";
+    }
+    if (token.type === "br") {
+      return " ";
+    }
+    if ("tokens" in token && Array.isArray(token.tokens)) {
+      return plainText(token.tokens);
+    }
+    return "text" in token && typeof token.text === "string" ? token.text : "";
+  }).join("");
+}
+function firstProse(tokens) {
+  for (const token of tokens) {
+    let text = "";
+    if (token.type === "paragraph" || token.type === "text") {
+      text = plainText(Array.isArray(token.tokens) ? token.tokens : [token]);
+    } else if (token.type === "list") {
+      text = firstProse(token.items.flatMap((item) => item.tokens));
+    } else if (token.type === "blockquote") {
+      text = firstProse(token.tokens ?? []);
+    }
+    const line = text.replace(/\s+/g, " ").trim();
+    if (line) {
+      return line;
+    }
+  }
+  return "";
+}
+function summarizeDescription(description) {
+  const line = firstProse(Lexer.lex(description));
+  if (line.length <= SUMMARY_MAX_CHARS) {
+    return line;
+  }
+  const cut = line.slice(0, SUMMARY_MAX_CHARS - 1);
+  const lastSpace = cut.lastIndexOf(" ");
+  return `${(lastSpace > SUMMARY_MAX_CHARS / 2 ? cut.slice(0, lastSpace) : cut).trimEnd()}\u2026`;
+}
+function compactBucketEntry(entry) {
+  const { description: _description, status: _status, hint: _hint, ...rest } = entry;
+  return rest;
+}
+function compactFlatRow(entry) {
+  const nested = entry.action;
+  const doc = nested && typeof nested === "object" ? nested : entry;
+  const { id, name, status, hint } = toRow(entry);
+  const assignee = entry.assignee && typeof entry.assignee === "object" ? entry.assignee : null;
+  return {
+    id,
+    name,
+    status,
+    ...typeof doc.priority === "string" ? { priority: doc.priority } : {},
+    ...Array.isArray(doc.tags) && doc.tags.length > 0 ? { tags: doc.tags } : {},
+    summary: summarizeDescription(typeof doc.description === "string" ? doc.description : ""),
+    ...hint ? { hint } : {},
+    ...typeof assignee?.name === "string" ? { assignee: assignee.name } : {}
+  };
+}
+function compactListData(data) {
+  if (Array.isArray(data)) {
+    return data.map((entry) => compactFlatRow(entry));
+  }
+  if (!data || typeof data !== "object") {
+    return data;
+  }
+  return Object.fromEntries(
+    Object.entries(data).map(([bucket, entries]) => [
+      bucket,
+      Array.isArray(entries) ? entries.map((entry) => compactBucketEntry(entry)) : entries
+    ])
+  );
+}
+function toRow(entry) {
+  const nested = entry.action;
+  const doc = nested && typeof nested === "object" ? nested : entry;
+  const id = doc.id ?? doc._id ?? entry.id ?? entry._id ?? entry.tempId ?? "?";
+  const status = doc.status ?? entry.status ?? entry.draftStatus ?? "";
+  let hint = typeof entry.hint === "string" ? entry.hint.trim() : "";
+  if (!hint && entry.isBlocked === true) {
+    const open = typeof entry.openBlockerCount === "number" ? entry.openBlockerCount : null;
+    hint = open === null ? "blocked" : `blocked by ${open} open Task${open === 1 ? "" : "s"}`;
+  }
+  return {
+    id: String(id),
+    name: String(doc.name ?? entry.name ?? "(unnamed)"),
+    status: String(status),
+    hint
+  };
+}
+function renderEntry(entry, full) {
+  const row = toRow(entry);
+  const suffix = row.status ? ` [${row.status}]` : "";
+  const lines = [`- \`${row.id}\` ${row.name}${suffix}`];
+  const nested = entry.action;
+  const doc = nested && typeof nested === "object" ? nested : entry;
+  const description = typeof doc.description === "string" ? doc.description : "";
+  const text = typeof entry.summary === "string" ? entry.summary : full ? description : summarizeDescription(description);
+  if (typeof text === "string" && text.trim()) {
+    lines.push(
+      ...text.trim().split("\n").map((line) => line ? `  ${line}` : "")
+    );
+  }
+  if (row.hint) {
+    lines.push(`  ${row.hint}`);
+  }
+  return lines;
+}
+function sharedHint(entries) {
+  const first = entries[0]?.hint;
+  return typeof first === "string" && entries.every((entry) => entry.hint === first) ? first : "";
+}
+function renderBucketRow(entry, shared) {
+  const { id, name } = toRow(entry);
+  const suffix = typeof entry.draftStatus === "string" ? ` [${entry.draftStatus}]` : "";
+  const lines = [`- \`${id}\` ${name}${suffix}`];
+  if (typeof entry.hint === "string" && entry.hint && entry.hint !== shared) {
+    lines.push(`  ${entry.hint}`);
+  }
+  if (Array.isArray(entry.blockedBy) && entry.blockedBy.length > 0) {
+    const blockers = entry.blockedBy.map((b) => `\`${b.id}\` ${b.name}`);
+    lines.push(`  blocked by: ${blockers.join(", ")}`);
+  }
+  const holder = entry.claimedByChat;
+  if (typeof holder?.title === "string") {
+    lines.push(`  held by chat: ${holder.title}`);
+  }
+  return lines;
+}
+function renderBuckets(data, full) {
+  const lines = [];
+  for (const [bucket, entries] of Object.entries(data)) {
+    if (!Array.isArray(entries) || entries.length === 0) {
+      continue;
+    }
+    const rows = entries;
+    if (full) {
+      lines.push(`## ${bucket} (${rows.length})`, ...rows.flatMap((entry) => renderEntry(entry, true)));
+    } else {
+      const shared = sharedHint(rows);
+      lines.push(`## ${bucket} (${rows.length})${shared ? `: ${shared}` : ""}`);
+      lines.push(...rows.flatMap((entry) => renderBucketRow(entry, shared)));
+    }
+    lines.push("");
+  }
+  return lines;
+}
+function renderMarkdown(data, hints, { full = false } = {}) {
+  let lines;
+  if (Array.isArray(data)) {
+    lines = data.flatMap((entry) => renderEntry(entry, full));
+  } else if (data && typeof data === "object") {
+    lines = renderBuckets(data, full);
+  } else {
+    lines = [];
+  }
+  if (lines.length === 0) {
+    return "No Tasks matched.\n";
+  }
+  for (const hint of hints) {
+    lines.push(`> ${hint}`);
+  }
+  return `${lines.join("\n").trimEnd()}
+`;
+}
+export {
+  buildListRequest,
+  compactListData,
+  listCommand,
+  renderMarkdown,
+  summarizeDescription
+};
+//# sourceMappingURL=list-LYRCC67M.js.map

package/dist/list-LYRCC67M.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/actions/list.ts"],"sourcesContent":["import type { ActionsListRequest, ActionsListResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { Lexer, type Token } from \"marked\";\nimport { apiPost } from \"../../client.ts\";\nimport { getEnv } from \"../../env.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { ACTIONS_LIST_DEFAULT_LIMIT, buildListHints, failApi } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"actions.list\",\n  description:\n    'List actions for the current company. Compact by default: a bucketed Task is its id and name (plus its blockers, holder or staged change); a flat row (--search, --bucketed=false) adds status, priority, tags and a one-line `summary` of its description. Checking whether a Task already exists? --search \"<words>\" returns the matches with their summaries. --full prints whole descriptions (or `baker actions get <id>` for one Task). Default: pre-bucketed (claimable/myClaims/blocked/claimedByOthers/completed/discarded), each bucket ordered do-first (blockers before blocked, then highest-leverage). The bucketed view reads the whole open backlog, so nothing pending is ever hidden from it. Set --bucketed=false for a flat list filterable by --status, orderable by --sort, and windowed by --limit. Looking for one Task by name? --search \"conversion goal\" --output md returns only the matching Tasks instead of the whole backlog.',\n  args: {\n    search: {\n      type: \"string\",\n      description:\n        'Find Tasks by words in their name, description or tags, searched on the server (e.g. --search \"conversion goal\"). Returns a flat list, best match first; by default it covers pending, in-progress and completed Tasks. Add --status to search one status instead, including discarded Tasks (--status discarded). Implies --bucketed=false.',\n      required: false,\n    },\n    bucketed: {\n      type: \"boolean\",\n      description: \"Pre-bucket the results based on the current chat (default: true)\",\n      required: false,\n      default: true,\n    },\n    status: {\n      type: \"string\",\n      description: \"Filter by status (only with --bucketed=false): pending|in_progress|completed|discarded\",\n      required: false,\n    },\n    sort: {\n      type: \"string\",\n      description:\n        \"Order a flat list (only with --bucketed=false): priority (do-first: blockers before blocked, then highest-leverage) | recent. Default: priority.\",\n      required: false,\n    },\n    limit: {\n      type: \"string\",\n      description: `How many Tasks a flat list reads, newest first (only with --bucketed=false). Default: ${ACTIONS_LIST_DEFAULT_LIMIT}. When the read comes back full, hints[] says so — raise --limit to reach older Tasks.`,\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description:\n        \"Print every Task's whole description and full record instead of the compact row. Large on a real backlog — prefer --search, or `baker actions get <id>` for one Task.\",\n      required: false,\n      default: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|md. Default: json\", required: false },\n  },\n});\n\nexport const listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List actions, one short row per Task (id and name; --search rows add a one-line summary). Default: bucketed view (claimable, myClaims, blocked, claimedByOthers). Use --bucketed=false for raw filter by --status, --search <text> to find Tasks by name, --full for whole descriptions.\",\n  },\n  args: {\n    search: { type: \"string\", description: \"Find Tasks by words in name/description/tags\", required: false },\n    bucketed: { type: \"boolean\", description: \"Pre-bucket by chat\", required: false, default: true },\n    status: { type: \"string\", description: \"Status filter (raw mode)\", required: false },\n    sort: { type: \"string\", description: \"Order (raw mode): priority|recent\", required: false },\n    limit: { type: \"string\", description: \"How many Tasks to read (raw mode)\", required: false },\n    full: {\n      type: \"boolean\",\n      description: \"Whole descriptions and full records\",\n      required: false,\n      default: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|md\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const body = buildListRequest(args, getEnv().BAKER_CHAT_ID);\n      const response = await apiPost<ActionsListResponse>(\"/api/actions/list\", body);\n      // Only the flat list is windowed — the bucketed view reads the whole open\n      // backlog, so there is nothing there to warn about.\n      const hints =\n        body.bucketed === false && body.limit !== undefined && response.ok && Array.isArray(response.data)\n          ? buildListHints({ returned: response.data.length, limit: body.limit })\n          : [];\n      if (args.output === \"md\" && response.ok) {\n        process.stdout.write(renderMarkdown(response.data, hints, { full: args.full === true }));\n        return;\n      }\n      const compact = !args.full && response.ok;\n      const shaped = compact ? { ...response, data: compactListData(response.data) } : response;\n      const envelope = hints.length > 0 ? { ...shaped, hints } : shaped;\n      if (compact) {\n        // Unindented: on a real backlog the indentation alone outweighed the Tasks.\n        process.stdout.write(`${JSON.stringify(envelope)}\\n`);\n        return;\n      }\n      writeJson(envelope);\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n\ntype ListArgs = {\n  bucketed?: boolean;\n  status?: string;\n  sort?: string;\n  limit?: string;\n  search?: string;\n};\n\n// `status` goes out as typed so the server refuses a misspelt one instead of the\n// CLI dropping it and returning every status.\ntype ListRequest = Omit<ActionsListRequest, \"status\"> & { status?: string };\n\n/**\n * The request `actions list` sends. A search is answered by the server's\n * full-text index over each Task's name, description and tags, which only the\n * flat list reads — so `--search` implies `--bucketed=false`.\n */\nexport function buildListRequest(args: ListArgs, chatId: string | undefined): ListRequest {\n  const q = args.search?.trim();\n  if (args.bucketed !== false && !q) {\n    return chatId ? { bucketed: true, chatId } : { bucketed: true };\n  }\n  const parsedLimit = args.limit === undefined ? Number.NaN : Number.parseInt(String(args.limit), 10);\n  const body: ListRequest = {\n    bucketed: false,\n    // Default to do-first ordering so the flat list matches its documented\n    // contract; only \"recent\" opts out. A search keeps relevance order.\n    sort: args.sort === \"recent\" ? \"recent\" : \"priority\",\n    limit: Number.isFinite(parsedLimit) && parsedLimit > 0 ? parsedLimit : ACTIONS_LIST_DEFAULT_LIMIT,\n  };\n  if (q) {\n    body.q = q;\n  }\n  if (args.status) {\n    body.status = args.status;\n  }\n  return body;\n}\n\n/** How long a Task's summary line may run before it is cut. */\nconst SUMMARY_MAX_CHARS = 100;\n\n/** The text a reader sees in inline markdown: emphasis, code and link markup dropped, images skipped. */\nfunction plainText(tokens: Token[]): string {\n  return tokens\n    .map((token) => {\n      if (token.type === \"image\" || token.type === \"html\") {\n        return \"\";\n      }\n      if (token.type === \"br\") {\n        return \" \";\n      }\n      if (\"tokens\" in token && Array.isArray(token.tokens)) {\n        return plainText(token.tokens);\n      }\n      return \"text\" in token && typeof token.text === \"string\" ? token.text : \"\";\n    })\n    .join(\"\");\n}\n\n/** The first run of prose in a block sequence — past headings, code blocks, rules and tables. */\nfunction firstProse(tokens: Token[]): string {\n  for (const token of tokens) {\n    let text = \"\";\n    if (token.type === \"paragraph\" || token.type === \"text\") {\n      text = plainText(Array.isArray(token.tokens) ? token.tokens : [token]);\n    } else if (token.type === \"list\") {\n      text = firstProse(token.items.flatMap((item: { tokens: Token[] }) => item.tokens));\n    } else if (token.type === \"blockquote\") {\n      text = firstProse(token.tokens ?? []);\n    }\n    const line = text.replace(/\\s+/g, \" \").trim();\n    if (line) {\n      return line;\n    }\n  }\n  return \"\";\n}\n\n/**\n * A Task's description reduced to its first line of prose — enough to tell two\n * Tasks with similar names apart without reading either in full.\n *\n * Descriptions are markdown written to be read in a panel, so the first block is\n * often a `## What changes` heading or a code fence; the markdown is parsed, and\n * the summary is the first paragraph or list item as a reader would see it.\n */\nexport function summarizeDescription(description: string): string {\n  const line = firstProse(Lexer.lex(description));\n  if (line.length <= SUMMARY_MAX_CHARS) {\n    return line;\n  }\n  const cut = line.slice(0, SUMMARY_MAX_CHARS - 1);\n  const lastSpace = cut.lastIndexOf(\" \");\n  return `${(lastSpace > SUMMARY_MAX_CHARS / 2 ? cut.slice(0, lastSpace) : cut).trimEnd()}…`;\n}\n\n/**\n * A bucket entry (published or staged-create) as its id and name, plus what only\n * this row says (its blockers, the chat holding it, its staged change). The\n * status and hint are the same for every row of a bucket, which already says them.\n */\nfunction compactBucketEntry(entry: Record<string, unknown>): Record<string, unknown> {\n  const { description: _description, status: _status, hint: _hint, ...rest } = entry;\n  return rest;\n}\n\n/**\n * A flat-list row (`ActionWithMeta`, the Task nested under `action`) as the same\n * short row a bucket entry is, plus the priority and tags only this shape carries.\n * The nested doc also holds `searchText`, a second copy of the whole description.\n */\nfunction compactFlatRow(entry: Record<string, unknown>): Record<string, unknown> {\n  const nested = entry.action;\n  const doc = nested && typeof nested === \"object\" ? (nested as Record<string, unknown>) : entry;\n  const { id, name, status, hint } = toRow(entry);\n  const assignee = entry.assignee && typeof entry.assignee === \"object\" ? (entry.assignee as { name?: unknown }) : null;\n  return {\n    id,\n    name,\n    status,\n    ...(typeof doc.priority === \"string\" ? { priority: doc.priority } : {}),\n    ...(Array.isArray(doc.tags) && doc.tags.length > 0 ? { tags: doc.tags } : {}),\n    summary: summarizeDescription(typeof doc.description === \"string\" ? doc.description : \"\"),\n    ...(hint ? { hint } : {}),\n    ...(typeof assignee?.name === \"string\" ? { assignee: assignee.name } : {}),\n  };\n}\n\n/**\n * The default `actions list` payload: every Task as a short row, never its full\n * description. A backlog's descriptions run to a kilobyte each, so printing them\n * all turned a \"does this Task already exist?\" check into ~110 KB of output.\n * `--full` prints the server's payload untouched.\n */\nexport function compactListData(data: unknown): unknown {\n  if (Array.isArray(data)) {\n    return data.map((entry) => compactFlatRow(entry as Record<string, unknown>));\n  }\n  if (!data || typeof data !== \"object\") {\n    return data;\n  }\n  return Object.fromEntries(\n    Object.entries(data).map(([bucket, entries]) => [\n      bucket,\n      Array.isArray(entries) ? entries.map((entry) => compactBucketEntry(entry as Record<string, unknown>)) : entries,\n    ]),\n  );\n}\n\n/**\n * Flatten either payload shape to the same row.\n *\n * The two responses do not agree, and the flat one is the odd shape: a bucket\n * entry carries `id`/`name`/`status`/`hint` at the top level, while the flat\n * list returns `ActionWithMeta` — the identity lives under `entry.action` as\n * `_id`/`name`/`status`, with the blocker counts as siblings. Reading the\n * bucket fields off both is how every flat row rendered as \"- `?` (unnamed)\".\n */\nfunction toRow(entry: Record<string, unknown>): {\n  id: string;\n  name: string;\n  status: string;\n  hint: string;\n} {\n  const nested = entry.action;\n  const doc = nested && typeof nested === \"object\" ? (nested as Record<string, unknown>) : entry;\n\n  const id = doc.id ?? doc._id ?? entry.id ?? entry._id ?? entry.tempId ?? \"?\";\n  const status = doc.status ?? entry.status ?? entry.draftStatus ?? \"\";\n\n  // `hint` is a bucket-entry field; the flat shape has none, so say the thing it\n  // does carry instead of dropping the row's only context.\n  let hint = typeof entry.hint === \"string\" ? entry.hint.trim() : \"\";\n  if (!hint && entry.isBlocked === true) {\n    const open = typeof entry.openBlockerCount === \"number\" ? entry.openBlockerCount : null;\n    hint = open === null ? \"blocked\" : `blocked by ${open} open Task${open === 1 ? \"\" : \"s\"}`;\n  }\n\n  return {\n    id: String(id),\n    name: String(doc.name ?? entry.name ?? \"(unnamed)\"),\n    status: String(status),\n    hint,\n  };\n}\n\n/** One Task as a line, plus its summary (or with `full`, its whole description) and hint indented under it. */\nfunction renderEntry(entry: Record<string, unknown>, full: boolean): string[] {\n  const row = toRow(entry);\n  const suffix = row.status ? ` [${row.status}]` : \"\";\n  const lines = [`- \\`${row.id}\\` ${row.name}${suffix}`];\n  // The description lives under `action` on flat rows; a compact row already\n  // carries its one-line `summary`.\n  const nested = entry.action;\n  const doc = nested && typeof nested === \"object\" ? (nested as Record<string, unknown>) : entry;\n  const description = typeof doc.description === \"string\" ? doc.description : \"\";\n  const text =\n    typeof entry.summary === \"string\" ? entry.summary : full ? description : summarizeDescription(description);\n  if (typeof text === \"string\" && text.trim()) {\n    lines.push(\n      ...text\n        .trim()\n        .split(\"\\n\")\n        .map((line) => (line ? `  ${line}` : \"\")),\n    );\n  }\n  if (row.hint) {\n    lines.push(`  ${row.hint}`);\n  }\n  return lines;\n}\n\n/** The hint every entry of a bucket shares, or \"\" when they differ (myClaims varies by staged change). */\nfunction sharedHint(entries: Record<string, unknown>[]): string {\n  const first = entries[0]?.hint;\n  return typeof first === \"string\" && entries.every((entry) => entry.hint === first) ? first : \"\";\n}\n\n/**\n * A bucket entry as its id and name, plus only what this row says that its\n * bucket does not: its staged change, its own hint, its open blockers, the chat\n * holding it. The bucket's shared hint is printed once, on its heading.\n */\nfunction renderBucketRow(entry: Record<string, unknown>, shared: string): string[] {\n  const { id, name } = toRow(entry);\n  const suffix = typeof entry.draftStatus === \"string\" ? ` [${entry.draftStatus}]` : \"\";\n  const lines = [`- \\`${id}\\` ${name}${suffix}`];\n  if (typeof entry.hint === \"string\" && entry.hint && entry.hint !== shared) {\n    lines.push(`  ${entry.hint}`);\n  }\n  if (Array.isArray(entry.blockedBy) && entry.blockedBy.length > 0) {\n    const blockers = (entry.blockedBy as { id: string; name: string }[]).map((b) => `\\`${b.id}\\` ${b.name}`);\n    lines.push(`  blocked by: ${blockers.join(\", \")}`);\n  }\n  const holder = entry.claimedByChat as { title?: unknown } | undefined;\n  if (typeof holder?.title === \"string\") {\n    lines.push(`  held by chat: ${holder.title}`);\n  }\n  return lines;\n}\n\n/** The bucketed payload: a dict of arrays, keyed by bucket name. */\nfunction renderBuckets(data: Record<string, unknown>, full: boolean): string[] {\n  const lines: string[] = [];\n  for (const [bucket, entries] of Object.entries(data)) {\n    if (!Array.isArray(entries) || entries.length === 0) {\n      continue;\n    }\n    const rows = entries as Record<string, unknown>[];\n    if (full) {\n      lines.push(`## ${bucket} (${rows.length})`, ...rows.flatMap((entry) => renderEntry(entry, true)));\n    } else {\n      const shared = sharedHint(rows);\n      lines.push(`## ${bucket} (${rows.length})${shared ? `: ${shared}` : \"\"}`);\n      lines.push(...rows.flatMap((entry) => renderBucketRow(entry, shared)));\n    }\n    lines.push(\"\");\n  }\n  return lines;\n}\n\n/** Compact, id-first Markdown of the server's payload (whole descriptions with\n *  `full`). The bucketed payload is a dict of arrays and the flat one is an\n *  array, and neither shape is guessable from the outside — an agent handed\n *  only JSON here wrote three throwaway walkers to discover it. */\nexport function renderMarkdown(data: unknown, hints: string[], { full = false }: { full?: boolean } = {}): string {\n  let lines: string[];\n  if (Array.isArray(data)) {\n    lines = data.flatMap((entry) => renderEntry(entry as Record<string, unknown>, full));\n  } else if (data && typeof data === \"object\") {\n    lines = renderBuckets(data as Record<string, unknown>, full);\n  } else {\n    lines = [];\n  }\n\n  if (lines.length === 0) {\n    return \"No Tasks matched.\\n\";\n  }\n\n  for (const hint of hints) {\n    lines.push(`> ${hint}`);\n  }\n  return `${lines.join(\"\\n\").trimEnd()}\\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/list-M4Z3WYPM.js

@@ -0,0 +1,76 @@
+import {
+  avatarRowNormalizer,
+  chatIdFromEnv,
+  failAvatarApi,
+  rosterHints,
+  rosterRow
+} from "./chunk-DLUWHZCE.js";
+import {
+  readAvatars
+} from "./chunk-KB5HBQEK.js";
+import "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/list.ts
+import { defineCommand } from "citty";
+var STATUSES = ["generating", "ready", "error", "archived"];
+registerSchema({
+  command: "avatars.list",
+  description: "List the company's avatars \u2014 the reusable AI presenters you can cast into images and video. Start here before creating one: an avatar that already exists carries a settled identity, so reusing it keeps the same face across every piece of work. Retired avatars are hidden unless you pass --status archived. Rows are compact on purpose; `baker avatars get <handle>` returns the subject description and the identity sheet URL you need to actually cast one.",
+  args: {
+    status: {
+      type: "string",
+      description: "Filter by status: generating|ready|error|archived (default: everything except archived)",
+      required: false,
+      enum: [...STATUSES]
+    },
+    limit: { type: "number", description: "Max avatars to return (1-100)", required: false }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List the company's avatars (reusable AI presenters). Only `ready` ones can be cast. Example: baker avatars list --status ready --output md"
+  },
+  args: {
+    status: { type: "string", description: "Filter: generating|ready|error|archived", required: false },
+    limit: { type: "string", description: "Max avatars to return (1-100)", required: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      const status = args.status;
+      if (status) params.status = status;
+      if (args.limit !== void 0) params.limit = args.limit;
+      const data = await readAvatars("/api/avatars", params);
+      const roster = data.avatars.map(rosterRow);
+      const currentChat = chatIdFromEnv();
+      const hints = rosterHints(
+        data.avatars.map((a) => ({ ...a, fromThisChat: Boolean(currentChat) && a.chatId === currentChat })),
+        status
+      );
+      const format = args.output || "json";
+      const fields = args.fields ? args.fields.split(",") : void 0;
+      if (format === "json") {
+        writeJson({ ok: true, data: { avatars: roster }, meta: { count: roster.length }, hints });
+        return;
+      }
+      writeOutput({ ok: true, data: roster }, format, fields, false, avatarRowNormalizer);
+    } catch (err) {
+      failAvatarApi(err);
+    }
+  }
+});
+export {
+  listCommand
+};
+//# sourceMappingURL=list-M4Z3WYPM.js.map

package/dist/list-SXYVDDMU.js

@@ -0,0 +1,57 @@
+import {
+  compactSource,
+  reportError
+} from "./chunk-35ENAFJX.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/list.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.sources.list",
+  description: "List the review pages feeding the testimonials library: each one's id, site, import status and how many reviews it has brought in.",
+  args: {}
+});
+function listSourceHints(sources) {
+  if (sources.length === 0) {
+    return [
+      "No review sources yet. If the client has a public review page (Google Maps, Trustpilot, Yelp, Tripadvisor, G2, Capterra, Amazon, App Store, Google Play), add it with `baker testimonials sources add <link>`."
+    ];
+  }
+  const hints = sources.filter((source) => source.status === "error").map(
+    (source) => `${source.label} on ${source.platformLabel} did not import: ${source.error ?? "the last import failed"} Retry once with \`baker testimonials sources sync ${source.id}\`; if it fails again, tell the user in plain words and carry on with the other sources.`
+  );
+  if (sources.some((source) => source.status === "importing")) {
+    hints.push("Some sources are still importing \u2014 their review counts will grow over the next minutes.");
+  }
+  return hints;
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List testimonial sources (id, site, import status, reviews imported).\n\nExample: baker testimonials sources list"
+  },
+  args: {},
+  run: async () => {
+    try {
+      const sources = await apiGet("/api/testimonials/sources/list");
+      const hints = listSourceHints(sources);
+      writeJson({ ok: true, data: sources.map(compactSource), hints: hints.length > 0 ? hints : void 0 });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  listCommand,
+  listSourceHints
+};
+//# sourceMappingURL=list-SXYVDDMU.js.map

package/dist/list-XFIOXFB2.js

@@ -0,0 +1,50 @@
+import {
+  compactSource,
+  isImporting,
+  reportError
+} from "./chunk-V43RLLZE.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/list.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "media-sources.list",
+  description: "List the social accounts connected as image/video sources, with each one's key, import status and how many images and videos it has brought in.",
+  args: {}
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List connected media sources (key, platform, import status, stored images/videos).\n\nExample: baker media-sources list"
+  },
+  args: {},
+  run: async () => {
+    try {
+      const { sources } = await apiGet("/api/media-sources/list");
+      const hints = [];
+      if (sources.length === 0) {
+        hints.push(
+          "No sources connected. Connect the brand's own accounts with `baker media-sources add <profile URL>` to fill the image and video libraries."
+        );
+      } else if (sources.some(isImporting)) {
+        hints.push("Some sources are still importing \u2014 their counts will grow over the next minutes.");
+      }
+      writeJson({ ok: true, data: sources.map(compactSource), hints: hints.length > 0 ? hints : void 0 });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  listCommand
+};
+//# sourceMappingURL=list-XFIOXFB2.js.map

package/dist/locations-PQWB7EGC.js

@@ -0,0 +1,40 @@
+import {
+  GOOGLE_ADS_LOCATIONS
+} from "./chunk-FEELV5IV.js";
+import "./chunk-7VHPAGPK.js";
+import {
+  writeAdsJson
+} from "./chunk-LHNL6JM2.js";
+import "./chunk-ML7DLFFY.js";
+import "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/locations.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.locations",
+  description: "List all supported geo target IDs for --location flag in Google Ads keyword commands.",
+  args: {}
+});
+var FIELDS = {
+  id: "Geo target ID to pass as --location",
+  name: "Country/region name"
+};
+var locationsCommand = defineCommand({
+  meta: {
+    name: "locations",
+    description: "List all supported geo target IDs for --location flag."
+  },
+  run: () => {
+    writeAdsJson({ ok: true, data: GOOGLE_ADS_LOCATIONS, fields: FIELDS });
+  }
+});
+export {
+  locationsCommand
+};
+//# sourceMappingURL=locations-PQWB7EGC.js.map

package/dist/locations-WNSET6RM.js

@@ -0,0 +1,67 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-JSEPE5EP.js";
+import "./chunk-LHNL6JM2.js";
+import {
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/locations.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  query: { type: "positional", description: "The place to look for, e.g. Madrid", required: true },
+  limit: { type: "string", description: "At most this many matches (default 20, max 100)", required: false }
+};
+registerSchema({
+  command: "ads.chatgpt.locations",
+  description: "Places ChatGPT Ads can target, found by name: each row's id is what `campaigns create|update --location-ids` takes. Countries go in --countries as two-letter codes instead.",
+  args: {
+    query: { type: "string", description: "The place to look for, e.g. Madrid", required: true },
+    limit: { type: "string", description: "At most this many matches (default 20, max 100)", required: false }
+  }
+});
+var locationsCommand = defineCommand({
+  meta: {
+    name: "locations",
+    description: `Find the id of a region, city, market or postcode to target or exclude \u2014 countries use --countries codes instead.
+
+Examples:
+  baker ads chatgpt locations Madrid
+  baker ads chatgpt locations "Comunidad Valenciana" --limit 5`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    await runChatgptRead(
+      `${CHATGPT_ADS_REFERENCE.overview}`,
+      () => apiGet("/api/ads/chatgpt/locations", {
+        q: String(args.query),
+        ...typeof args.limit === "string" && args.limit ? { limit: args.limit } : {}
+      }),
+      locationHints
+    );
+  }
+});
+function locationHints(places) {
+  if (places.length === 0) {
+    return ["No place matched. Try the local or English name, or a broader area."];
+  }
+  const unserved = [...new Set(places.filter((place) => !place.served).map((place) => place.countryCode))];
+  return [
+    "Target one with `campaigns create|update --location-ids <id>` (or exclude it with `--excluded-location-ids`) \u2014 the id, not the name.",
+    ...unserved.length > 0 ? [
+      `ChatGPT Ads did not serve in ${unserved.join(", ")} when Baker last checked (served: false): a campaign targeting those places is refused at publish.`
+    ] : []
+  ];
+}
+export {
+  locationHints,
+  locationsCommand
+};
+//# sourceMappingURL=locations-WNSET6RM.js.map