@erdoai/cli 0.35.0 → 0.37.0

package/dist/index.js

@@ -606,11 +606,13 @@ var ErdoClient = class {
     return this.request("GET", `/v1/threads/${encodeURIComponent(threadId)}/messages`);
   }
   // --- datasets ---
-  listDatasets() {
-    return this.request(
-      "GET",
-      "/v1/datasets"
-    );
+  // class filters by structural class: omit (default) to show durable tables and
+  // hide scratch analysis by-products; "table"/"scratch" to select one; "all" for both.
+  listDatasets(params) {
+    const q = new URLSearchParams();
+    if (params?.class) q.set("class", params.class);
+    const qs = q.toString();
+    return this.request("GET", `/v1/datasets${qs ? `?${qs}` : ""}`);
   }
   // The endpoint's field is `question` (QueryDataNaturalLanguageInput). Sending
   // `query` made every `erdo datasets query` fail with "question is required".
@@ -790,12 +792,24 @@ var ErdoClient = class {
   // 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 });
+  reviewPages(urls, goal, audience) {
+    const body = { urls };
+    if (goal) body.goal = goal;
+    if (audience) body.audience = audience;
+    return this.request("POST", "/v1/page-reviews", body);
   }
   getPageReview(id) {
     return this.request("GET", `/v1/page-reviews/${encodeURIComponent(id)}`);
   }
+  // List past reviews newest first as lean summaries (id, status, URLs, scores —
+  // no findings). Pass a url to track one page's score over time.
+  listPageReviews(url, limit) {
+    const params = new URLSearchParams();
+    if (url) params.set("url", url);
+    if (limit) params.set("limit", String(limit));
+    const qs = params.toString();
+    return this.request("GET", `/v1/page-reviews${qs ? "?" + qs : ""}`);
+  }
   updatePage(pageID, input) {
     return this.request("PUT", `/v1/pages/${encodeURIComponent(pageID)}`, input);
   }
@@ -2562,10 +2576,13 @@ pagesCmd.command("review <url...>").description(
 ).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"
+).option(
+  "--audience <audience>",
+  "who the page targets \u2014 the ICP ('out-of-state condo investors') \u2014 the critic judges clarity, proof, and tone through that reader's eyes; a page that evidently speaks to someone else is itself a finding"
 ).action(async (urls, opts) => {
   try {
     const client = new ErdoClient();
-    const started = await client.reviewPages(urls, opts.goal);
+    const started = await client.reviewPages(urls, opts.goal, opts.audience);
     if (!opts.wait) {
       print(started);
       return;
@@ -2588,6 +2605,15 @@ pagesCmd.command("review <url...>").description(
     fail(e);
   }
 });
+pagesCmd.command("reviews").description(
+  "List past page reviews (newest first) as lean summaries \u2014 id, status, reviewed URLs, and conversion scores, without the findings. --url filters to reviews that included that exact page: the way to see one page's score over time."
+).option("--url <url>", "only reviews whose submitted URLs include this exact page URL").option("--limit <n>", "max reviews to return (default 20, max 100)").action(async (opts) => {
+  try {
+    print(await new ErdoClient().listPageReviews(opts.url, opts.limit ? Number(opts.limit) : void 0));
+  } catch (e) {
+    fail(e);
+  }
+});
 pagesCmd.command("review-result <id>").description("Read a page review by id \u2014 its status and, once ready, the typed per-page findings").action(async (id) => {
   try {
     print(await new ErdoClient().getPageReview(id));
@@ -2596,10 +2622,14 @@ pagesCmd.command("review-result <id>").description("Read a page review by id \u2
   }
 });
 var datasetsCmd = program.command("datasets").description("Datasets");
-datasetsCmd.command("list").description("List datasets").action(async () => {
-  try {
-    const { datasets } = await new ErdoClient().listDatasets();
-    for (const d of datasets) console.log(`${d.slug}	${d.type}	${d.status}	${d.name}`);
+datasetsCmd.command("list").description("List datasets").option(
+  "--class <class>",
+  "filter by structural class: 'table' or 'scratch', or 'all' to include scratch analysis by-products (default hides scratch)"
+).action(async (opts) => {
+  try {
+    const { datasets } = await new ErdoClient().listDatasets({ class: opts.class });
+    for (const d of datasets)
+      console.log(`${d.slug}	${d.type}	${d.status}	${d.class ?? "-"}	${d.name}`);
   } catch (e) {
     fail(e);
   }

package/package.json

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