@koda-sl/baker-cli 0.367.0 → 0.369.0

package/README.md

@@ -943,7 +943,8 @@ baker ads meta creatives create   --account-id act_123 --page 555 --instagram-us
 baker ads meta ads create         --account-id act_123 --name "Ad 1" --adset meta_temp_as --creative meta_temp_cr
 
 # review + edit before publish
-baker ads meta draft
+baker ads meta draft                       # one line per op: ref · kind · summary · after <refs>, then advisories
+baker ads meta draft --json                # raw JSON envelope for scripting
 baker ads meta draft show meta_temp_cr     # full staged payload — the receipt before publish
 baker ads meta draft remove meta_temp_cr   # removing a create cascades to dependents
 baker ads meta draft clear
@@ -3458,7 +3459,8 @@ baker actions list                         # default: bucketed (claimable, myCla
 # then most recent. The `blocked` bucket is ordered closest-to-ready first.
 baker actions list --bucketed=false --status pending
 baker actions list --bucketed=false --sort priority   # flat list, do-first order (default); use --sort recent for newest-first
-baker actions list --output md             # id-first Markdown; works for both the bucketed and flat shapes
+baker actions list --output md             # id-first Markdown; each bucket's guidance on its heading, blockers/holder under a row; flat rows add a one-line summary
+baker actions list --full                  # whole descriptions and full records (large on a real backlog)
 baker actions list --search "conversion goal" --output md   # find Tasks by words in name/description/tags (flat, best match first)
 # With BAKER_CHAT_ID, the bucketed list folds in THIS chat's draft: staged creates appear in
 # `draftCreates`; published actions being completed/discarded/updated carry a `draftStatus` marker.

package/dist/cli.js

@@ -9258,9 +9258,10 @@ var linkCommand = defineCommand7({
 
 // src/commands/actions/list.ts
 import { defineCommand as defineCommand8 } from "citty";
+import { Lexer } from "marked";
 registerSchema({
   command: "actions.list",
-  description: 'List actions for the current company. 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.',
+  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",
@@ -9288,13 +9289,19 @@ registerSchema({
       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 listCommand2 = defineCommand8({
   meta: {
     name: "list",
-    description: "List actions. Default: bucketed view (claimable, myClaims, blocked, claimedByOthers). Use --bucketed=false for raw filter by --status, or --search <text> to find Tasks by name."
+    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 },
@@ -9302,6 +9309,12 @@ var listCommand2 = defineCommand8({
     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: args5 }) => {
@@ -9309,9 +9322,16 @@ var listCommand2 = defineCommand8({
       const body = buildListRequest(args5, getEnv().BAKER_CHAT_ID);
       const response = await apiPost("/api/actions/list", body);
       const hints2 = body.bucketed === false && body.limit !== void 0 && response.ok && Array.isArray(response.data) ? buildListHints({ returned: response.data.length, limit: body.limit }) : [];
-      const envelope = hints2.length > 0 ? { ...response, hints: hints2 } : response;
-      if (args5.output === "md" && envelope.ok) {
-        process.stdout.write(renderMarkdown(envelope.data, hints2));
+      if (args5.output === "md" && response.ok) {
+        process.stdout.write(renderMarkdown(response.data, hints2, { full: args5.full === true }));
+        return;
+      }
+      const compact3 = !args5.full && response.ok;
+      const shaped = compact3 ? { ...response, data: compactListData(response.data) } : response;
+      const envelope = hints2.length > 0 ? { ...shaped, hints: hints2 } : shaped;
+      if (compact3) {
+        process.stdout.write(`${JSON.stringify(envelope)}
+`);
         return;
       }
       writeJson(envelope);
@@ -9341,6 +9361,81 @@ function buildListRequest(args5, chatId) {
   }
   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 text2 = "";
+    if (token.type === "paragraph" || token.type === "text") {
+      text2 = plainText(Array.isArray(token.tokens) ? token.tokens : [token]);
+    } else if (token.type === "list") {
+      text2 = firstProse(token.items.flatMap((item) => item.tokens));
+    } else if (token.type === "blockquote") {
+      text2 = firstProse(token.tokens ?? []);
+    }
+    const line = text2.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;
@@ -9358,35 +9453,69 @@ function toRow(entry) {
     hint
   };
 }
-function renderEntry(entry) {
+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 text2 = typeof entry.summary === "string" ? entry.summary : full ? description : summarizeDescription(description);
+  if (typeof text2 === "string" && text2.trim()) {
+    lines.push(
+      ...text2.trim().split("\n").map((line) => line ? `  ${line}` : "")
+    );
+  }
   if (row.hint) {
     lines.push(`  ${row.hint}`);
   }
   return lines;
 }
-function renderBuckets(data) {
+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;
     }
-    lines.push(`## ${bucket} (${entries.length})`);
-    for (const entry of entries) {
-      lines.push(...renderEntry(entry));
+    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, hints2) {
+function renderMarkdown(data, hints2, { full = false } = {}) {
   let lines;
   if (Array.isArray(data)) {
-    lines = data.flatMap((entry) => renderEntry(entry));
+    lines = data.flatMap((entry) => renderEntry(entry, full));
   } else if (data && typeof data === "object") {
-    lines = renderBuckets(data);
+    lines = renderBuckets(data, full);
   } else {
     lines = [];
   }
@@ -9829,7 +9958,7 @@ import { defineCommand as defineCommand19 } from "citty";
 function listed(resources) {
   return resources.map((resource) => resource.label ? `${resource.id} (${resource.label})` : resource.id).join("; ");
 }
-function connectedResourceHints({ plural, singular, flag, resources }) {
+function connectedResourceHints({ plural: plural2, singular, flag, resources }) {
   if (resources.length === 0) {
     return [];
   }
@@ -9837,7 +9966,7 @@ function connectedResourceHints({ plural, singular, flag, resources }) {
     return [`This company connected one ${singular}: ${listed(resources)}. Commands use it unless you pass ${flag}.`];
   }
   return [
-    `This company connected ${resources.length} ${plural}: ${listed(resources)}. Each command works on one, so pass ${flag} \u2014 nothing is picked for you. A question about the whole business covers all ${resources.length}: answering from one and reporting it as the total is wrong.`
+    `This company connected ${resources.length} ${plural2}: ${listed(resources)}. Each command works on one, so pass ${flag} \u2014 nothing is picked for you. A question about the whole business covers all ${resources.length}: answering from one and reporting it as the total is wrong.`
   ];
 }
 
@@ -27041,11 +27170,114 @@ Examples:
 
 // src/commands/ads/meta/draft.ts
 import { defineCommand as defineCommand65 } from "citty";
-async function listDraft2(chat) {
+
+// src/commands/ads/meta/draft-status.ts
+var STATUS_HEADINGS = {
+  active: "staged",
+  publishing: "publishing",
+  applied: "published",
+  partial: "published with failures",
+  discarded: "discarded",
+  none: "none"
+};
+function plural(count2, word) {
+  return `${count2} ${word}${count2 === 1 ? "" : "s"}`;
+}
+function headingLine(draft) {
+  const heading = STATUS_HEADINGS[draft.status];
+  if (draft.status === "active" || draft.status === "discarded") {
+    return `Meta Ads \u2014 ${plural(draft.count, "change")} ${heading} \xB7 ${draft.mode}`;
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const op of draft.ops) {
+    const status = op.result?.status ?? "pending";
+    counts.set(status, (counts.get(status) ?? 0) + 1);
+  }
+  const summary = [...counts].map(([status, count2]) => `${count2} ${status}`).join(", ");
+  return `Meta Ads \u2014 ${heading} \xB7 ${summary} \xB7 ${draft.mode}`;
+}
+function resultPart(op) {
+  const result = op.result;
+  if (!result) {
+    return void 0;
+  }
+  if (result.status === "failed") {
+    return `\u2717 failed: ${result.error ?? "no reason recorded"}`;
+  }
+  if (result.status === "skipped") {
+    const because = result.skippedBecause;
+    if (because && op.dependsOn.includes(because)) {
+      return `\u2717 skipped: ${because} did not apply`;
+    }
+    return `\u2717 skipped: ${because ?? "a change it needs did not apply"}`;
+  }
+  const id = result.id ?? result.hash;
+  const applied = `\u2713 ${result.status}${id ? ` \u2192 ${id}` : ""}`;
+  const verification = result.verification;
+  if (verification && verification.status !== "confirmed") {
+    return `${applied} (read-back ${verification.status}${verification.note ? `: ${verification.note}` : ""})`;
+  }
+  return applied;
+}
+function opLine(op, showAccount) {
+  const parts = [op.ref, op.kind, op.summary];
+  if (op.target && op.target !== op.ref) {
+    parts.push(`target ${op.target}`);
+  }
+  if (showAccount) {
+    parts.push(`account ${op.accountId}`);
+  }
+  if (op.dependsOn.length > 0) {
+    parts.push(`after ${op.dependsOn.join(", ")}`);
+  }
+  const result = resultPart(op);
+  if (result) {
+    parts.push(result);
+  }
+  return `  ${parts.join(" \xB7 ").replace(/[\r\n]+/g, " ")}`;
+}
+function renderDraftStatus3(draft) {
+  if (draft.status === "none" || draft.count === 0) {
+    return "No staged Meta changes on this chat.";
+  }
+  const lines = [headingLine(draft)];
+  if (draft.status === "active") {
+    lines.push("Publishing makes every change real on the ad account.");
+  }
+  lines.push("");
+  const showAccount = new Set(draft.ops.map((op) => op.accountId)).size > 1;
+  for (const op of draft.ops) {
+    lines.push(opLine(op, showAccount));
+  }
+  if (draft.advisories.length > 0) {
+    lines.push("", "Advisories");
+    for (const advisory of draft.advisories) {
+      lines.push(`  ! ${advisory.ref}: ${advisory.message}`);
+    }
+  }
+  lines.push("", "Full staged payload for one op: baker ads meta draft show <ref> \xB7 raw envelope: --json");
+  return lines.join("\n");
+}
+
+// src/commands/ads/meta/draft.ts
+registerSchema({
+  command: "ads.meta.draft",
+  description: "Review every Meta op staged on this chat, one line each: ref \xB7 kind \xB7 summary \xB7 what it waits on, and after a publish \u2713 applied \u2192 id or \u2717 failed: <error>. `draft show <ref>` prints one op's full payload.",
+  args: {
+    json: { type: "boolean", description: "Raw JSON envelope instead of the readable list", required: false },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+async function listDraft2(json, chat) {
   try {
     const chatId = resolveChatId(chat);
     const response = await apiPost("/api/ads/meta/draft", { chatId });
-    writeJsonEnvelope(response);
+    if (json || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus3(response.data)}
+`);
   } catch (err) {
     handleMetaError(err);
   }
@@ -27053,11 +27285,14 @@ async function listDraft2(chat) {
 var listCommand10 = defineCommand65({
   meta: {
     name: "list",
-    description: "Show every Meta write op staged in this chat, its dependencies, and post-publish results. Publishing reaches the real ad account, so review this before you finish. Example: baker ads meta draft"
+    description: "Show every Meta write op staged in this chat, one line each (ref \xB7 kind \xB7 summary \xB7 dependencies \xB7 post-publish result); --json for the raw envelope. Publishing reaches the real ad account, so review this before you finish. Example: baker ads meta draft"
+  },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" },
+    chat: CHAT_READ_ARG
   },
-  args: { chat: CHAT_READ_ARG },
   run: async ({ args: args5 }) => {
-    await listDraft2(args5.chat);
+    await listDraft2(args5.json === true, args5.chat);
   }
 });
 var showCommand2 = defineCommand65({
@@ -27127,7 +27362,10 @@ var metaDraftCommand = defineCommand65({
   },
   // Declared on the parent too: `default: "list"` dispatches the bare `draft --chat <id>` form, and
   // citty prints help for a flag the parent does not know instead of forwarding it.
-  args: { chat: CHAT_READ_ARG },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" },
+    chat: CHAT_READ_ARG
+  },
   subCommands: { list: listCommand10, show: showCommand2, remove: removeCommand3, clear: clearCommand3 },
   // `default` (not `run`) dispatches the bare invocation: citty falls through to `run`
   // after dispatching a subcommand, so a `run` here would list the draft a second time
@@ -28940,7 +29178,7 @@ function renderNode3(node, depth, showAccount, out) {
   }
 }
 var NO_CHANGES = "No X Ads changes staged";
-var STATUS_HEADINGS = {
+var STATUS_HEADINGS2 = {
   active: "staged",
   publishing: "publishing",
   applied: "published",
@@ -28952,8 +29190,8 @@ function didNotApply(op) {
 function didApply(op) {
   return op.result?.status === "applied" || op.result?.status === "simulated";
 }
-function headingLine(draft) {
-  const heading = STATUS_HEADINGS[draft.status] ?? draft.status;
+function headingLine2(draft) {
+  const heading = STATUS_HEADINGS2[draft.status] ?? draft.status;
   if (draft.status !== "applied" && draft.status !== "publishing") {
     return `X Ads: ${draft.count} change${draft.count === 1 ? "" : "s"} ${heading}`;
   }
@@ -28967,11 +29205,11 @@ function problemLines(draft) {
     return `\u2717 ${op.summary} \u2014 failed: ${reason}`;
   });
 }
-function renderDraftStatus3(draft) {
+function renderDraftStatus4(draft) {
   if (draft.status === "none" || draft.count === 0) {
     return NO_CHANGES;
   }
-  const out = [headingLine(draft), ""];
+  const out = [headingLine2(draft), ""];
   const tree = draft.tree ?? [];
   const showAccount = accountsInTree3(tree).size > 1;
   for (const node of tree) {
@@ -29009,7 +29247,7 @@ async function listDraft3(json, chat) {
       writeJsonEnvelope(response);
       return;
     }
-    process.stdout.write(`${renderDraftStatus3(response.data)}
+    process.stdout.write(`${renderDraftStatus4(response.data)}
 `);
   } catch (err) {
     handleDraftError(err);