@koda-sl/baker-cli 0.368.0 → 0.369.0

package/README.md

@@ -3459,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 = [];
   }