@erdoai/cli 0.32.0 → 0.34.0

package/dist/index.js

@@ -310,6 +310,29 @@ var ErdoClient = class {
   createProject(input) {
     return this.request("POST", "/v1/projects", input);
   }
+  // --- pages ---
+  listPages(params) {
+    const q = new URLSearchParams();
+    if (params?.query) q.set("query", params.query);
+    if (params?.createdAfter) q.set("created_after", params.createdAfter);
+    if (params?.createdBefore) q.set("created_before", params.createdBefore);
+    if (params?.limit) q.set("limit", String(params.limit));
+    if (params?.offset) q.set("offset", String(params.offset));
+    const qs = q.toString();
+    return this.request("GET", `/v1/pages${qs ? `?${qs}` : ""}`);
+  }
+  deletePage(id) {
+    return this.request(
+      "DELETE",
+      `/v1/pages/${encodeURIComponent(id)}`
+    );
+  }
+  restorePage(id) {
+    return this.request(
+      "POST",
+      `/v1/pages/restore/${encodeURIComponent(id)}`
+    );
+  }
   // --- workstreams ---
   listWorkstreams(status) {
     const q = new URLSearchParams();
@@ -465,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();
@@ -729,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)}`);
@@ -2201,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"
 );
@@ -2329,10 +2438,40 @@ pagesCmd.command("validate").description("Validate page content without deployin
     fail(e);
   }
 });
-pagesCmd.command("list").description("List artifacts (pages, charts, ...)").option("-t, --type <type>", "filter by type (e.g. html_page)").option("-l, --limit <n>", "max results", (v) => parseInt(v, 10)).action(async (opts) => {
+pagesCmd.command("list").description("List pages (newest first). With --type, lists any artifact type instead.").option("-t, --type <type>", "list all artifacts of this type (e.g. html) rather than just pages").option("--query <substr>", "case-insensitive title substring filter (pages only)").option("--created-after <iso>", "only pages created at/after this RFC3339 timestamp (pages only)").option("--created-before <iso>", "only pages created at/before this RFC3339 timestamp (pages only)").option("-l, --limit <n>", "max results", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).action(
+  async (opts) => {
+    try {
+      if (opts.type) {
+        const { artifacts } = await new ErdoClient().listArtifacts(opts.type, opts.limit);
+        for (const a of artifacts) console.log(`${a.id}	${a.type}	${a.title}`);
+        return;
+      }
+      const { pages } = await new ErdoClient().listPages({
+        query: opts.query,
+        createdAfter: opts.createdAfter,
+        createdBefore: opts.createdBefore,
+        limit: opts.limit,
+        offset: opts.offset
+      });
+      for (const p of pages) {
+        const vis = p.public ? p.public_url || "public" : "private";
+        console.log(`${p.id}	${p.created_at}	${vis}	${p.title}`);
+      }
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
+pagesCmd.command("delete <id>").description("Delete a page (soft delete \u2014 unpublishes it and hides it from listings; restorable)").action(async (id) => {
+  try {
+    print(await new ErdoClient().deletePage(id));
+  } catch (e) {
+    fail(e);
+  }
+});
+pagesCmd.command("restore <id>").description("Restore a previously deleted page (comes back private)").action(async (id) => {
   try {
-    const { artifacts } = await new ErdoClient().listArtifacts(opts.type, opts.limit);
-    for (const a of artifacts) console.log(`${a.id}	${a.type}	${a.title}`);
+    print(await new ErdoClient().restorePage(id));
   } catch (e) {
     fail(e);
   }
@@ -2346,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.32.0",
+  "version": "0.34.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {