@koda-sl/baker-cli 0.498.0 → 0.500.0

package/dist/linkedin-person-DSLAOKKN.js

@@ -0,0 +1,137 @@
+import {
+  linkedinPersonHints
+} from "./chunk-TESOYFMQ.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-GSKZ3ZDO.js";
+import "./chunk-5MSRVAUZ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-ERSL4WZT.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/linkedin-person.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.linkedin-person",
+  description: "Read one person's public LinkedIn profile once \u2014 who they are, the organisation they're at, their About, recent posts and articles \u2014 to write a 1:1 ad or account page in their own words. Nothing is stored or followed. Start here: `baker research linkedin-person https://www.linkedin.com/in/<name>`.",
+  args: {
+    url: {
+      type: "string",
+      description: "Their profile link, linkedin.com/in/<name> (positional)",
+      required: true
+    },
+    full: {
+      type: "boolean",
+      description: "Also return the provider's whole answer (education, projects, recommendations, similar profiles)",
+      required: false,
+      default: false
+    }
+  }
+});
+var FIELDS = {
+  private: "true when LinkedIn doesn't show the profile publicly \u2014 nothing else comes back",
+  name: "Their name",
+  location: "Where the profile says they are",
+  about: "Their About section, in their words",
+  current_role: "The organisation they're at now (first on the profile with no end date). LinkedIn no longer shows job titles publicly",
+  recent_posts: "Their latest posts: text, date, link, and LinkedIn's label (Post, or a reshare)",
+  articles: "Articles they have published: title, date, link",
+  raw: "The provider's whole answer (--full only)"
+};
+function linkedinPersonFix(code) {
+  if (code === "VALIDATION_ERROR" || code === "BAD_REQUEST") {
+    return {
+      action: "retry_with_changes",
+      explanation: "Pass the person's profile link, of the form https://www.linkedin.com/in/<name>. Company pages are not people."
+    };
+  }
+  if (code === "NOT_FOUND") {
+    return {
+      action: "continue_without",
+      explanation: "There's no profile at that link. Check the link once; otherwise write the brief from what you have and say this person couldn't be read."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "This read failed. Don't loop on it \u2014 finish the brief from the account's company-level priorities and name this person as a gap."
+  };
+}
+var linkedinPersonCommand = defineCommand({
+  meta: {
+    name: "linkedin-person",
+    description: `Read one person's public LinkedIn profile, once, to write a 1:1 ad or account page from their own stated priorities.
+
+Returns their name, location, About, the organisation they're at now, their recent posts and articles. LinkedIn no longer shows headlines or job titles publicly, so take the title from where you found the person.
+
+For ad and page messaging only: nothing is stored or followed. Quote what matters into the creative brief; never save the person to Knowledge.
+
+Examples:
+  baker research linkedin-person https://www.linkedin.com/in/jane-doe
+  baker research linkedin-person https://es.linkedin.com/in/jane-doe --full`
+  },
+  args: {
+    url: { type: "positional", description: "Their profile link, linkedin.com/in/<name>", required: false },
+    full: { type: "boolean", description: "Also return the provider's whole answer", required: false }
+  },
+  run: async ({ args }) => {
+    const url = args.url;
+    if (!url) {
+      writeResearchJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "A LinkedIn profile link is required",
+          fix: linkedinPersonFix("VALIDATION_ERROR")
+        }
+      });
+      process.exit(1);
+    }
+    const body = { url, full: Boolean(args.full) };
+    try {
+      const { person, raw } = await apiPost("/api/research/linkedin-person", body);
+      if (person.private) {
+        writeResearchJson({
+          ok: true,
+          data: { private: true, profile_url: person.profileUrl },
+          fields: FIELDS,
+          hints: linkedinPersonHints({ isPrivate: true, postCount: 0 })
+        });
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data: {
+          private: false,
+          profile_url: person.profileUrl,
+          name: person.name,
+          location: person.location,
+          about: person.about,
+          current_role: person.currentRole,
+          recent_posts: person.recentPosts,
+          articles: person.articles,
+          ...raw ? { raw } : {}
+        },
+        fields: FIELDS,
+        hints: linkedinPersonHints({ isPrivate: false, postCount: person.recentPosts.length })
+      });
+    } catch (err) {
+      handleResearchError(err, linkedinPersonFix);
+    }
+  }
+});
+export {
+  linkedinPersonCommand
+};
+//# sourceMappingURL=linkedin-person-DSLAOKKN.js.map

package/dist/linkedin-person-DSLAOKKN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/linkedin-person.ts"],"sourcesContent":["import type { ResearchLinkedinPersonRequest, ResearchLinkedinPersonResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { linkedinPersonHints } from \"./hints.ts\";\nimport { handleResearchError, type ResearchFix, writeResearchJson } from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.linkedin-person\",\n  description:\n    \"Read one person's public LinkedIn profile once — who they are, the organisation they're at, their About, recent posts and articles — to write a 1:1 ad or account page in their own words. Nothing is stored or followed. Start here: `baker research linkedin-person https://www.linkedin.com/in/<name>`.\",\n  args: {\n    url: {\n      type: \"string\",\n      description: \"Their profile link, linkedin.com/in/<name> (positional)\",\n      required: true,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Also return the provider's whole answer (education, projects, recommendations, similar profiles)\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\nconst FIELDS: Record<string, string> = {\n  private: \"true when LinkedIn doesn't show the profile publicly — nothing else comes back\",\n  name: \"Their name\",\n  location: \"Where the profile says they are\",\n  about: \"Their About section, in their words\",\n  current_role:\n    \"The organisation they're at now (first on the profile with no end date). LinkedIn no longer shows job titles publicly\",\n  recent_posts: \"Their latest posts: text, date, link, and LinkedIn's label (Post, or a reshare)\",\n  articles: \"Articles they have published: title, date, link\",\n  raw: \"The provider's whole answer (--full only)\",\n};\n\nfunction linkedinPersonFix(code: string): ResearchFix {\n  if (code === \"VALIDATION_ERROR\" || code === \"BAD_REQUEST\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation:\n        \"Pass the person's profile link, of the form https://www.linkedin.com/in/<name>. Company pages are not people.\",\n    };\n  }\n  if (code === \"NOT_FOUND\") {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"There's no profile at that link. Check the link once; otherwise write the brief from what you have and say this person couldn't be read.\",\n    };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"This read failed. Don't loop on it — finish the brief from the account's company-level priorities and name this person as a gap.\",\n  };\n}\n\nexport const linkedinPersonCommand = defineCommand({\n  meta: {\n    name: \"linkedin-person\",\n    description: `Read one person's public LinkedIn profile, once, to write a 1:1 ad or account page from their own stated priorities.\n\nReturns their name, location, About, the organisation they're at now, their recent posts and articles. LinkedIn no longer shows headlines or job titles publicly, so take the title from where you found the person.\n\nFor ad and page messaging only: nothing is stored or followed. Quote what matters into the creative brief; never save the person to Knowledge.\n\nExamples:\n  baker research linkedin-person https://www.linkedin.com/in/jane-doe\n  baker research linkedin-person https://es.linkedin.com/in/jane-doe --full`,\n  },\n  args: {\n    url: { type: \"positional\", description: \"Their profile link, linkedin.com/in/<name>\", required: false },\n    full: { type: \"boolean\", description: \"Also return the provider's whole answer\", required: false },\n  },\n  run: async ({ args }) => {\n    const url = args.url as string | undefined;\n    if (!url) {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"A LinkedIn profile link is required\",\n          fix: linkedinPersonFix(\"VALIDATION_ERROR\"),\n        },\n      });\n      process.exit(1);\n    }\n\n    const body: ResearchLinkedinPersonRequest = { url, full: Boolean(args.full) };\n\n    try {\n      const { person, raw } = await apiPost<ResearchLinkedinPersonResponse>(\"/api/research/linkedin-person\", body);\n      if (person.private) {\n        writeResearchJson({\n          ok: true,\n          data: { private: true, profile_url: person.profileUrl },\n          fields: FIELDS,\n          hints: linkedinPersonHints({ isPrivate: true, postCount: 0 }),\n        });\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data: {\n          private: false,\n          profile_url: person.profileUrl,\n          name: person.name,\n          location: person.location,\n          about: person.about,\n          current_role: person.currentRole,\n          recent_posts: person.recentPosts,\n          articles: person.articles,\n          ...(raw ? { raw } : {}),\n        },\n        fields: FIELDS,\n        hints: linkedinPersonHints({ isPrivate: false, postCount: person.recentPosts.length }),\n      });\n    } catch (err) {\n      handleResearchError(err, linkedinPersonFix);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,KAAK;AAAA,MACH,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,EACF;AACF,CAAC;AAED,IAAM,SAAiC;AAAA,EACrC,SAAS;AAAA,EACT,MAAM;AAAA,EACN,UAAU;AAAA,EACV,OAAO;AAAA,EACP,cACE;AAAA,EACF,cAAc;AAAA,EACd,UAAU;AAAA,EACV,KAAK;AACP;AAEA,SAAS,kBAAkB,MAA2B;AACpD,MAAI,SAAS,sBAAsB,SAAS,eAAe;AACzD,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,aACE;AAAA,IACJ;AAAA,EACF;AACA,MAAI,SAAS,aAAa;AACxB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,aACE;AAAA,IACJ;AAAA,EACF;AACA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,aACE;AAAA,EACJ;AACF;AAEO,IAAM,wBAAwB,cAAc;AAAA,EACjD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASf;AAAA,EACA,MAAM;AAAA,IACJ,KAAK,EAAE,MAAM,cAAc,aAAa,8CAA8C,UAAU,MAAM;AAAA,IACtG,MAAM,EAAE,MAAM,WAAW,aAAa,2CAA2C,UAAU,MAAM;AAAA,EACnG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,MAAM,KAAK;AACjB,QAAI,CAAC,KAAK;AACR,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM;AAAA,UACN,SAAS;AAAA,UACT,KAAK,kBAAkB,kBAAkB;AAAA,QAC3C;AAAA,MACF,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,OAAsC,EAAE,KAAK,MAAM,QAAQ,KAAK,IAAI,EAAE;AAE5E,QAAI;AACF,YAAM,EAAE,QAAQ,IAAI,IAAI,MAAM,QAAwC,iCAAiC,IAAI;AAC3G,UAAI,OAAO,SAAS;AAClB,0BAAkB;AAAA,UAChB,IAAI;AAAA,UACJ,MAAM,EAAE,SAAS,MAAM,aAAa,OAAO,WAAW;AAAA,UACtD,QAAQ;AAAA,UACR,OAAO,oBAAoB,EAAE,WAAW,MAAM,WAAW,EAAE,CAAC;AAAA,QAC9D,CAAC;AACD;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,MAAM;AAAA,UACJ,SAAS;AAAA,UACT,aAAa,OAAO;AAAA,UACpB,MAAM,OAAO;AAAA,UACb,UAAU,OAAO;AAAA,UACjB,OAAO,OAAO;AAAA,UACd,cAAc,OAAO;AAAA,UACrB,cAAc,OAAO;AAAA,UACrB,UAAU,OAAO;AAAA,UACjB,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;AAAA,QACvB;AAAA,QACA,QAAQ;AAAA,QACR,OAAO,oBAAoB,EAAE,WAAW,OAAO,WAAW,OAAO,YAAY,OAAO,CAAC;AAAA,MACvF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,KAAK,iBAAiB;AAAA,IAC5C;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/list-3HOASRXD.js

@@ -0,0 +1,57 @@
+import {
+  compactSource,
+  reportError
+} from "./chunk-EDWRTYEO.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-3HOASRXD.js.map

package/dist/list-3M6LPVUB.js

@@ -0,0 +1,65 @@
+import {
+  projectBatch
+} from "./chunk-OG6IHSQF.js";
+import {
+  failStudioCommand
+} from "./chunk-4KZMKI67.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/list.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "studio.list",
+  description: "Recent Studio batches for THIS conversation, newest first \u2014 what you have already generated, so you re-use a take instead of paying for it twice. `--all` widens it to everything the company generated, including what people ran themselves in the dashboard.",
+  args: {
+    kind: { type: "string", description: "image | video (default both)", required: false, enum: ["image", "video"] },
+    limit: { type: "number", description: "How many batches, 1-50 (default 10)", required: false, default: 10 },
+    all: { type: "boolean", description: "Every batch for the company, not just this conversation", required: false },
+    full: { type: "boolean", description: "Include settings, references and attribution", required: false }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Recent Studio batches, newest first. Scoped to this conversation unless you pass --all.\n\nExample: baker studio list\nExample: baker studio list --kind video --limit 5\nExample: baker studio list --all   # includes batches the client ran in the dashboard"
+  },
+  args: {
+    kind: { type: "string", description: "image | video", required: false },
+    limit: { type: "string", description: "How many batches (default 10, max 50)", required: false },
+    all: { type: "boolean", description: "Company-wide instead of this conversation", required: false },
+    full: { type: "boolean", description: "Include settings, references and attribution", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      if (args.kind) params.kind = args.kind;
+      if (args.limit) params.limit = String(args.limit);
+      if (args.all) params.scope = "company";
+      const { generations } = await apiGet("/api/studio/generations", params);
+      const data = generations.map((generation) => projectBatch(generation, args.full === true));
+      writeJson({
+        ok: true,
+        data,
+        meta: { count: data.length },
+        hints: data.length === 0 ? [
+          args.all ? "Nothing has been generated for this company yet. `baker studio generate <prompt>` starts the first batch." : "This conversation has generated nothing yet. Add --all to see what the client generated in the dashboard before you make something new."
+        ] : []
+      });
+    } catch (error) {
+      failStudioCommand(error);
+    }
+  }
+});
+export {
+  listCommand
+};
+//# sourceMappingURL=list-3M6LPVUB.js.map

package/dist/list-C3AQ4TMI.js

@@ -0,0 +1,93 @@
+import {
+  reportError,
+  validationError
+} from "./chunk-JRCYNIXC.js";
+import {
+  adUseVerdictSchema,
+  postsListQuerySchema,
+  socialPersonRoleSchema,
+  socialPostPlatformSchema
+} from "./chunk-NZS3KEQ2.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/posts/list.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  account: {
+    type: "string",
+    description: "Only this followed account, by its key (linkedin:in/jane-doe) \u2014 `baker media-sources list`",
+    required: false
+  },
+  role: {
+    type: "string",
+    description: `Only people with this role: ${socialPersonRoleSchema.options.join("|")}`,
+    required: false
+  },
+  platform: { type: "string", description: socialPostPlatformSchema.options.join("|"), required: false },
+  usable: {
+    type: "string",
+    description: `Whether it can run as a paid ad: ${adUseVerdictSchema.options.join("|")}`,
+    required: false
+  },
+  "about-company": {
+    type: "boolean",
+    description: "Only posts that name the company, in the text or the comments \u2014 the ABM picks (--no-about-company: only the others)",
+    required: false
+  },
+  since: { type: "string", description: "Only posts published on or after this date (2026-09-01)", required: false },
+  sort: { type: "string", description: "date (default, newest first) | engagement", required: false },
+  limit: { type: "string", description: "Max posts (default 50, max 200)", required: false }
+};
+registerSchema({
+  command: "posts.list",
+  description: "List the posts of the followed accounts, newest first, with their numbers and whether each can run as an ad.",
+  args: Object.fromEntries(
+    Object.entries(ARGS).map(([name, arg]) => [
+      name,
+      { type: arg.type, description: arg.description, required: false }
+    ])
+  )
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List posts of followed accounts. Start here.\n\nExamples:\n  baker posts list --role ceo\n  baker posts list --usable usable --sort engagement\n  baker posts list --account linkedin:acme --since 2026-09-01"
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const raw = Object.fromEntries(
+      Object.entries(args).filter(([name, value]) => name in ARGS && value !== void 0 && value !== "").map(([name, value]) => [name, String(value)])
+    );
+    const parsed = postsListQuerySchema.safeParse(raw);
+    if (!parsed.success) validationError(parsed.error.issues[0]?.message ?? "Invalid filters");
+    try {
+      const { posts } = await apiGet("/api/posts/list", raw);
+      const hints = [];
+      if (posts.length === 0) {
+        hints.push(
+          "No posts match. Follow the company's pages and its key people first: `baker media-sources add <profile link> [--role ceo]`; a private profile's posts are added one by one with `baker posts add <post link>`."
+        );
+      } else {
+        hints.push(
+          "Read one in full \u2014 its text, numbers and why it can or can't run as an ad: `baker posts get <id>`."
+        );
+      }
+      writeJson({ ok: true, data: posts, hints });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  listCommand
+};
+//# sourceMappingURL=list-C3AQ4TMI.js.map

package/dist/list-JKB33W6K.js

@@ -0,0 +1,304 @@
+import {
+  ACTIONS_LIST_DEFAULT_LIMIT,
+  buildListHints,
+  failApi
+} from "./chunk-XYBSTW3P.js";
+import "./chunk-5MSRVAUZ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-ERSL4WZT.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import {
+  getEnv
+} from "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-JKB33W6K.js.map