@erdoai/cli 0.33.0 → 0.34.0

package/dist/index.js

@@ -488,6 +488,22 @@ var ErdoClient = class {
       input
     );
   }
+  // --- activity feed ---
+  // The unified, ranked, read-only feed: attention items, approvals, workstream
+  // events, catalog updates, and urgent cause-clusters. Respond via
+  // respondAttentionItem / decideApproval — this is a view only.
+  listActivityFeed(params) {
+    const q = new URLSearchParams();
+    if (params?.limit) q.set("limit", String(params.limit));
+    if (params?.offset) q.set("offset", String(params.offset));
+    if (params?.categories) q.set("categories", params.categories);
+    if (params?.scope) q.set("scope", params.scope);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/activity/feed${qs ? `?${qs}` : ""}`
+    );
+  }
   // --- knowledge review queue ---
   listReviewItems(params) {
     const q = new URLSearchParams();
@@ -752,9 +768,11 @@ var ErdoClient = class {
     return this.request("POST", "/v1/pages", input);
   }
   // Start a review of external page URLs with the real landing critic; returns a
-  // review id immediately (poll getPageReview for the typed findings).
-  reviewPages(urls) {
-    return this.request("POST", "/v1/page-reviews", { urls });
+  // review id immediately (poll getPageReview for the typed findings). goal is
+  // the operator's optional declared campaign goal — it steers which conversion
+  // principles apply, and a page whose evident form contradicts it is a finding.
+  reviewPages(urls, goal) {
+    return this.request("POST", "/v1/page-reviews", goal ? { urls, goal } : { urls });
   }
   getPageReview(id) {
     return this.request("GET", `/v1/page-reviews/${encodeURIComponent(id)}`);
@@ -2224,6 +2242,74 @@ attnCmd.command("respond <id>").description(
     }
   }
 );
+function activityLine(it) {
+  const handle = it.slug || it.id;
+  const parts = [it.title || it.type];
+  if (it.summary && it.summary !== it.title) {
+    const s = it.summary.replace(/\s+/g, " ").trim();
+    parts.push(`\u2014 ${s.length > 80 ? `${s.slice(0, 79)}\u2026` : s}`);
+  }
+  return `  ${handle}  ${parts.join(" ")}`;
+}
+function activityAction(it) {
+  if (it.type === "approval_request") return `erdo approvals decide ${it.id} --approve|--reject`;
+  return `erdo attention respond ${it.slug || it.id}`;
+}
+function renderActivityFeed(feed) {
+  const items = feed.items ?? [];
+  const needs = items.filter((it) => it.needs_action);
+  if (needs.length > 0) {
+    console.log("NEEDS YOU");
+    for (const it of needs) {
+      const sev = it.severity ? `[${it.severity}] ` : "";
+      console.log(`  ${sev}${it.title || it.type}`);
+      console.log(`    ${activityAction(it)}`);
+    }
+    console.log("");
+  }
+  const clusters = feed.urgent_clusters ?? [];
+  if (clusters.length > 0) {
+    console.log("URGENT");
+    if (feed.flood_summary) console.log(`  ${feed.flood_summary}`);
+    for (const c of clusters) console.log(`  \u2022 ${c.summary} (${c.count})`);
+    console.log("");
+  }
+  const rest = items.filter((it) => !it.needs_action && !it.clustered);
+  if (rest.length > 0) {
+    console.log("RECENT");
+    for (const it of rest) console.log(activityLine(it));
+    console.log("");
+  }
+  if (needs.length === 0 && clusters.length === 0 && rest.length === 0) {
+    console.log("Nothing in the feed.");
+    return;
+  }
+  console.log(`${items.length} shown \xB7 ${feed.total} total`);
+}
+program.command("activity").alias("feed").description(
+  "The unified activity feed \u2014 needs-you items first, then urgent cause-clusters, then recent activity. Read-only: respond with `erdo attention respond` / `erdo approvals decide`."
+).option("-n, --limit <n>", "max items (default 20, max 100)", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).option(
+  "--categories <list>",
+  "comma-separated: attention,approval,workstream,catalog,job,heartbeat (default excludes runs)"
+).option("--scope <scope>", "following | all (default all)").option("--json", "raw JSON response").action(
+  async (opts) => {
+    try {
+      const feed = await new ErdoClient().listActivityFeed({
+        limit: opts.limit,
+        offset: opts.offset,
+        categories: opts.categories,
+        scope: opts.scope
+      });
+      if (opts.json) {
+        print(feed);
+        return;
+      }
+      renderActivityFeed(feed);
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 var reviewsCmd = program.command("reviews").description(
   "The Knowledge Review queue \u2014 knowledge patches the critic proposes, investigations, and deduplicated failure signals awaiting a human decision"
 );
@@ -2399,10 +2485,13 @@ pagesCmd.command("get <id>").description("Show an artifact").action(async (id) =
 });
 pagesCmd.command("review <url...>").description(
   "Review external landing page URLs with Erdo's real conversion critic \u2014 typed defects (severity, issue, why it costs conversions, evidence, fix) plus strengths, judged from fold + full-page captures on desktop and mobile. Returns a review id; use --wait to poll and print the findings."
-).option("--wait", "poll until the review is ready, then print the findings").action(async (urls, opts) => {
+).option("--wait", "poll until the review is ready, then print the findings").option(
+  "--goal <goal>",
+  "what the page's campaign is trying to achieve ('book demos', 'brand awareness for a launch') \u2014 steers which conversion principles apply; a page whose evident form contradicts the goal is itself a finding"
+).action(async (urls, opts) => {
   try {
     const client = new ErdoClient();
-    const started = await client.reviewPages(urls);
+    const started = await client.reviewPages(urls, opts.goal);
     if (!opts.wait) {
       print(started);
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {