@koda-sl/baker-cli 0.231.0 → 0.232.0

package/README.md

@@ -2198,6 +2198,8 @@ baker images ingest https://img.freepik.com/free-photo/xyz.jpg --source magnific
 baker images ingest https://acme.com/hero.png --source firecrawl --external-url https://acme.com/pricing --context "competitor pricing hero"
 ```
 
+`--source` is a closed set, validated before the request so a wrong value costs nothing: `uploaded`, `website`, `google_testimonial`, `trustpilot_testimonial`, `instagram`, `magnific`, `brandfetch`, `google_images`, `firecrawl`, `screenshotone`, `iconify`, `giphy`, `pinterest`, `ai_generated`, `layer_edit`. Use `website` for an asset pulled off a company's own site.
+
 Returns `{ imageId, deduped, contentHash }`. When `deduped: true`, an existing library row is returned — no new bytes are stored. Max ingest size 25MB.
 
 **Flags:**
@@ -2404,8 +2406,11 @@ Width, height, aspect ratio, and format — read from the image header without f
 ```bash
 baker images dimensions ./logo.png
 baker images dimensions https://acme.com/hero.png
+baker images dimensions ./logo.png --output md --fields width,height
 ```
 
+Takes `--output json|md` and `--fields <a,b>` like the other image reads. As everywhere else in the CLI, `--fields` projects only the `md` and `files` formats — the default `json` output always returns the whole envelope.
+
 Response:
 
 ```json
@@ -2980,6 +2985,7 @@ 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
 # 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.
 # Only the caller's own chat draft is reflected — never another chat's staged work.

package/dist/cli.js

@@ -7114,7 +7114,8 @@ registerSchema({
       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
-    }
+    },
+    output: { type: "string", description: "Output format: json|md. Default: json", required: false }
   }
 });
 var listCommand2 = defineCommand8({
@@ -7126,33 +7127,102 @@ var listCommand2 = defineCommand8({
     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 }
+    limit: { type: "string", description: "How many Tasks to read (raw mode)", required: false },
+    output: { type: "string", description: "Output format: json|md", required: false }
   },
   run: async ({ args }) => {
     try {
-      const env = getEnv();
       const bucketed = args.bucketed !== false;
-      const body = { bucketed };
-      if (bucketed && env.BAKER_CHAT_ID) {
-        body.chatId = env.BAKER_CHAT_ID;
-      }
       const parsedLimit = args.limit === void 0 ? Number.NaN : Number.parseInt(String(args.limit), 10);
       const limit = Number.isFinite(parsedLimit) && parsedLimit > 0 ? parsedLimit : ACTIONS_LIST_DEFAULT_LIMIT;
-      if (!bucketed) {
-        if (args.status) {
-          body.status = args.status;
-        }
-        body.sort = args.sort === "recent" ? "recent" : "priority";
-        body.limit = limit;
-      }
+      const body = buildRequestBody(args, bucketed, limit);
       const response = await apiPost("/api/actions/list", body);
       const hints = !bucketed && response.ok && Array.isArray(response.data) ? buildListHints({ returned: response.data.length, limit }) : [];
-      writeJson(hints.length > 0 ? { ...response, hints } : response);
+      const envelope = hints.length > 0 ? { ...response, hints } : response;
+      if (args.output === "md" && envelope.ok) {
+        process.stdout.write(renderMarkdown(envelope.data, hints));
+        return;
+      }
+      writeJson(envelope);
     } catch (err) {
       failApi(err);
     }
   }
 });
+function buildRequestBody(args, bucketed, limit) {
+  const env = getEnv();
+  const body = { bucketed };
+  if (bucketed) {
+    if (env.BAKER_CHAT_ID) {
+      body.chatId = env.BAKER_CHAT_ID;
+    }
+    return body;
+  }
+  if (args.status) {
+    body.status = args.status;
+  }
+  body.sort = args.sort === "recent" ? "recent" : "priority";
+  body.limit = limit;
+  return body;
+}
+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) {
+  const row = toRow(entry);
+  const suffix = row.status ? ` [${row.status}]` : "";
+  const lines = [`- \`${row.id}\` ${row.name}${suffix}`];
+  if (row.hint) {
+    lines.push(`  ${row.hint}`);
+  }
+  return lines;
+}
+function renderBuckets(data) {
+  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));
+    }
+    lines.push("");
+  }
+  return lines;
+}
+function renderMarkdown(data, hints) {
+  let lines;
+  if (Array.isArray(data)) {
+    lines = data.flatMap((entry) => renderEntry(entry));
+  } else if (data && typeof data === "object") {
+    lines = renderBuckets(data);
+  } else {
+    lines = [];
+  }
+  if (lines.length === 0) {
+    return "No Tasks matched.\n";
+  }
+  for (const hint of hints) {
+    lines.push(`> ${hint}`);
+  }
+  return `${lines.join("\n").trimEnd()}
+`;
+}
 
 // src/commands/actions/log.ts
 import { defineCommand as defineCommand9 } from "citty";
@@ -14278,7 +14348,7 @@ function sortFindings(findings) {
     return SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity];
   });
 }
-function renderMarkdown(result) {
+function renderMarkdown2(result) {
   const lines = [];
   lines.push(`# LinkedIn Ads Audit \u2014 ${result.account.name} (${result.account.id})`);
   lines.push("");
@@ -14363,7 +14433,7 @@ Examples:
       const result = { ...data, findings: sorted };
       const fmt = args.format ?? "json";
       if (fmt === "md") {
-        process.stdout.write(`${renderMarkdown(result)}
+        process.stdout.write(`${renderMarkdown2(result)}
 `);
         return;
       }
@@ -32200,7 +32270,7 @@ function outputRows(rows, args, response, cached) {
   }
   writeJsonEnvelope({ ...response, ...cached && { cached: true } });
 }
-function buildRequestBody(args, propertyId, useCache) {
+function buildRequestBody2(args, propertyId, useCache) {
   const body = { propertyId };
   if (args.preset) body.preset = args.preset;
   if (args.dimensions) body.dimensions = args.dimensions.split(",").map((d) => d.trim());
@@ -32275,7 +32345,7 @@ Free-form (escape hatch):
     }
     const propertyId = await resolvePropertyId(args);
     const useCache = !args["no-cache"];
-    const body = buildRequestBody(args, propertyId, useCache);
+    const body = buildRequestBody2(args, propertyId, useCache);
     const cacheKey = buildQueryCacheKey(propertyId, JSON.stringify(body));
     if (useCache) {
       const cached = cacheGet("ga4-queries", cacheKey);
@@ -32871,7 +32941,7 @@ function outputRows2(rows, args, response, cached) {
   }
   writeJsonEnvelope({ ...response, ...cached && { cached: true } });
 }
-function buildRequestBody2(args, siteUrl, useCache) {
+function buildRequestBody3(args, siteUrl, useCache) {
   const body = { siteUrl };
   if (args.preset) body.preset = args.preset;
   if (args.brand) body.brand = args.brand;
@@ -32955,7 +33025,7 @@ Free-form (escape hatch):
     }
     const siteUrl = await resolveSiteUrl(args);
     const useCache = !args["no-cache"];
-    const body = buildRequestBody2(args, siteUrl, useCache);
+    const body = buildRequestBody3(args, siteUrl, useCache);
     const cacheKey = buildQueryCacheKey(siteUrl, JSON.stringify(body));
     if (useCache) {
       const cached = cacheGet("gsc-queries", cacheKey);
@@ -34121,7 +34191,13 @@ registerSchema({
   command: "images.dimensions",
   description: "Return width, height, aspect ratio, and format for a local file or remote URL.",
   args: {
-    target: { type: "string", description: "Local file path or remote http(s) URL", required: true }
+    target: { type: "string", description: "Local file path or remote http(s) URL", required: true },
+    output: { type: "string", description: "Output format: json|md. Default: json", required: false },
+    fields: {
+      type: "string",
+      description: "Comma-separated field names to include (e.g. width,height)",
+      required: false
+    }
   }
 });
 var dimensionsCommand = defineCommand130({
@@ -34130,7 +34206,13 @@ var dimensionsCommand = defineCommand130({
     description: "Read image dimensions without decoding the full file.\n\nExample: baker images dimensions ./logo.png\nExample: baker images dimensions https://acme.com/hero.png"
   },
   args: {
-    target: { type: "positional", description: "Local file path or remote http(s) URL", required: false }
+    target: { type: "positional", description: "Local file path or remote http(s) URL", required: false },
+    output: { type: "string", description: "Output format: json|md", required: false },
+    // --fields is the flag an agent reaches for when it wants two numbers out of
+    // six. It used to be accepted silently and ignored (citty drops unknown
+    // flags), so the caller assumed the projection had failed and fell back to
+    // regexing raw JSON. Accepting it is cheaper than explaining it.
+    fields: { type: "string", description: "Comma-separated field names to include", required: false }
   },
   run: async ({ args }) => {
     try {
@@ -34148,17 +34230,23 @@ var dimensionsCommand = defineCommand130({
         });
         process.exit(1);
       }
-      writeJson({
-        ok: true,
-        data: {
-          target,
-          source: isRemoteUrl(target) ? "url" : "file",
-          width: dims.width,
-          height: dims.height,
-          aspectRatio: Math.round(dims.aspectRatio * 1e4) / 1e4,
-          format: dims.format
-        }
-      });
+      writeOutput(
+        {
+          ok: true,
+          data: {
+            target,
+            source: isRemoteUrl(target) ? "url" : "file",
+            width: dims.width,
+            height: dims.height,
+            aspectRatio: Math.round(dims.aspectRatio * 1e4) / 1e4,
+            format: dims.format
+          }
+        },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        false,
+        (record) => record
+      );
     } catch (err) {
       const message = err instanceof Error ? err.message : "Unexpected error";
       writeJson({ ok: false, error: { code: "IMAGE_PROCESSING_ERROR", message } });
@@ -35216,12 +35304,13 @@ var iconCommand = defineCommand138({
 
 // src/commands/images/ingest.ts
 import { defineCommand as defineCommand139 } from "citty";
+var SOURCE_VALUES = imageSourceSchema.options.join(" | ");
 registerSchema({
   command: "images.ingest",
   description: "Ingest a remote image URL into the library (full describe + embed).",
   args: {
     url: { type: "string", description: "Image URL to ingest", required: true },
-    source: { type: "string", description: "Image source enum", required: true },
+    source: { type: "string", description: `Where the image came from. One of: ${SOURCE_VALUES}`, required: true },
     "external-id": { type: "string", description: "Provider asset id", required: false },
     "external-url": { type: "string", description: "Canonical page URL", required: false },
     context: { type: "string", description: "Description context hint", required: false },
@@ -35236,7 +35325,7 @@ var ingestCommand = defineCommand139({
   },
   args: {
     url: { type: "positional", description: "Image URL", required: false },
-    source: { type: "string", description: "Source enum", required: false },
+    source: { type: "string", description: `Where the image came from. One of: ${SOURCE_VALUES}`, required: false },
     "external-id": { type: "string", description: "Provider asset id", required: false },
     "external-url": { type: "string", description: "Canonical page URL", required: false },
     context: { type: "string", description: "Description context", required: false },
@@ -35252,10 +35341,29 @@ var ingestCommand = defineCommand139({
         process.exit(1);
       }
       if (!source) {
-        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "--source is required" } });
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: "--source is required",
+            fix: `Pass one of: ${SOURCE_VALUES}. Use "website" for an asset pulled off a company's own site.`
+          }
+        });
+        process.exit(1);
+      }
+      const parsedSource = imageSourceSchema.safeParse(source);
+      if (!parsedSource.success) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `--source "${source}" is not a known image source`,
+            fix: `Pass one of: ${SOURCE_VALUES}. Use "website" for an asset pulled off a company's own site.`
+          }
+        });
         process.exit(1);
       }
-      const body = { url, source };
+      const body = { url, source: parsedSource.data };
       if (args["external-id"]) body.externalId = args["external-id"];
       if (args["external-url"]) body.externalUrl = args["external-url"];
       if (args.context) body.descriptionContext = args.context;