@koda-sl/baker-cli 0.212.0 → 0.214.0

package/README.md

@@ -2691,7 +2691,11 @@ baker winning-ads follow "https://www.linkedin.com/company/acme" --platform link
 
 ### `baker winning-ads following`
 
-List the brands you follow → `GET /api/ad-library/following`. Each row shows `status` (`ready` vs `adding…`) plus cached counts (`active_ad_count`, `total_ad_count`, `family_count`) and discovery progress (`adding_discovered`, `adding_enqueued`). `--full` adds `image_url` + `platforms`.
+List the brands you follow → `GET /api/ad-library/following`. Each row shows `status` (`ready` vs `adding…`) plus cached counts (`active_ad_count`, `total_ad_count`, `family_count`) and progress through the two stages of adding a brand (`adding_discovered`, `adding_enqueued`, `adding_ingested` — the last two are both counts for the current run, so they read as a fraction). `--full` adds `image_url` + `platforms`.
+
+**A brand's counts only mean something once it is `ready`.** While it is `adding…` they are a lie in progress. And `discovery_failed: true` on a `ready` brand says we finished but couldn't see everything, so its counts are *short* — which is not the same as the brand running no ads, though both show zero. Re-run `follow` on it to try again.
+
+Response `hints` name both cases: brands we couldn't finish, and brands still filling in. In `--output md`/`files` the table is the payload and the hints are written to **stderr** so they still surface without corrupting the output.
 
 ```bash
 baker winning-ads following --output md

package/dist/cli.js

@@ -1441,7 +1441,7 @@ var resolvePreviewSchema = z2.object({
   website: z2.string().nullable(),
   followers: z2.number().nullable()
 });
-var followedStatusSchema = z2.enum(["discovering", "ready"]);
+var followedStatusSchema = z2.enum(["discovering", "ingesting", "ready"]);
 var followedAdvertiserSchema = z2.object({
   // Baker subscription row id (used to unfollow).
   followed_id: z2.string(),
@@ -1453,9 +1453,15 @@ var followedAdvertiserSchema = z2.object({
   active_ad_count: z2.number().nullable(),
   total_ad_count: z2.number().nullable(),
   family_count: z2.number().nullable(),
-  // Progress while status === "discovering".
+  // Progress while status is "discovering" or "ingesting". `adding_ingested`
+  // and `adding_enqueued` are both counts for the CURRENT run, so they read as
+  // a fraction; `total_ad_count` is the brand's whole corpus and is not.
   adding_discovered: z2.number().nullable(),
-  adding_enqueued: z2.number().nullable()
+  adding_enqueued: z2.number().nullable(),
+  adding_ingested: z2.number().nullable(),
+  // A discovery job ended in failure, so this brand's ads are under-counted.
+  // Distinguishes "we couldn't finish looking" from "this brand runs no ads".
+  discovery_failed: z2.boolean().nullable()
 });
 var followingListResponseSchema = z2.object({
   following: z2.array(followedAdvertiserSchema)
@@ -40079,7 +40085,7 @@ registerSchema({
     prompt: { type: "string", description: "Additional prompt instructions for the spawned agent", required: false },
     template: {
       type: "string",
-      description: "Run one of Baker's templates on this schedule, by its id from `baker scheduled-actions templates --list`. The recipe's brief and prompt are resolved from the catalog every time it fires, so it stays current; use --description to carry what is specific to this company. Refused if that template is already set up here.",
+      description: "Start this schedule from one of Baker's templates, by its id from `baker scheduled-actions templates --list`. The template's brief is **copied** onto the task, so the person who owns it can read and edit exactly what it will do; anything you pass in --prompt is appended after it. Editing the template later does not change a task already built from it, and the same template can be used more than once.",
       required: false
     }
   }
@@ -44207,7 +44213,7 @@ var followCompetitorsCommand = defineCommand207({
 import { defineCommand as defineCommand208 } from "citty";
 registerSchema({
   command: "winning-ads.following",
-  description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts.",
+  description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts. A brand still adding has counts that are a lie in progress; one with `discovery_failed` has counts that are short because we couldn't finish looking, which is not the same as it running no ads.",
   args: {}
 });
 function displayStatus(status) {
@@ -44223,9 +44229,30 @@ function compactFollowed(record) {
     total_ad_count: record.total_ad_count ?? null,
     family_count: record.family_count ?? null,
     adding_discovered: record.adding_discovered ?? null,
-    adding_enqueued: record.adding_enqueued ?? null
+    adding_enqueued: record.adding_enqueued ?? null,
+    adding_ingested: record.adding_ingested ?? null,
+    // Without this a brand we failed to finish looking at is indistinguishable
+    // from one that genuinely runs no ads — both read `ready` with 0 ads.
+    discovery_failed: record.discovery_failed ?? null
   };
 }
+function followingHints(records) {
+  const hints = [];
+  const label = (r) => String(r.label ?? r.advertiser_id ?? "");
+  const incomplete = records.filter((r) => r.discovery_failed === true && r.status !== "adding\u2026");
+  if (incomplete.length > 0) {
+    hints.push(
+      `${incomplete.length} brand(s) couldn't be fully added: ${incomplete.map(label).join(", ")}. Their counts are incomplete \u2014 re-run \`baker winning-ads follow <domain>\` for each to try again.`
+    );
+  }
+  const adding = records.filter((r) => r.status === "adding\u2026");
+  if (adding.length > 0) {
+    hints.push(
+      `${adding.length} brand(s) are still being added: ${adding.map(label).join(", ")}. Their ad counts fill in over the next few minutes \u2014 don't report them as final, and don't re-follow to speed it up.`
+    );
+  }
+  return hints;
+}
 function followingNormalizer(record, full) {
   const compact2 = compactFollowed(record);
   if (!full) {
@@ -44240,7 +44267,7 @@ function followingNormalizer(record, full) {
 var followingCommand = defineCommand208({
   meta: {
     name: "following",
-    description: "List brands you follow, with status (ready / adding\u2026) and cached counts. Example: baker winning-ads following --output md"
+    description: "List brands you follow, with status (ready / adding\u2026) and cached counts. A brand's counts are only final once it is ready. Example: baker winning-ads following --output md"
   },
   args: {
     output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
@@ -44253,13 +44280,14 @@ var followingCommand = defineCommand208({
       const output = args.output || "json";
       const full = args.full;
       const rawList = Array.isArray(data?.following) ? data.following : [];
+      const following = rawList.map((f) => followingNormalizer(f, full));
+      const hints = followingHints(following);
       if (output === "json") {
-        const following = rawList.map((f) => followingNormalizer(f, full));
-        writeJson({ ok: true, data: { following } });
+        writeJson({ ok: true, data: { following }, hints: hints.length > 0 ? hints : void 0 });
         return;
       }
       writeOutput(
-        { ok: true, data: rawList },
+        { ok: true, data: rawList, hints: hints.length > 0 ? hints : void 0 },
         output,
         args.fields ? args.fields.split(",") : void 0,
         full,