@erdoai/cli 0.28.0 → 0.30.0

package/dist/index.js

@@ -209,6 +209,12 @@ var ErdoClient = class {
   setAutonomyMode(mode) {
     return this.request("PUT", "/v1/autonomy-mode", { mode });
   }
+  // Run a read-only HogQL query against the org's page-analytics events. Rows are
+  // positional per columns; enabled:false means page analytics is off for the org
+  // (not zero traffic). A rejected query surfaces PostHog's message as the error.
+  queryPageAnalytics(query) {
+    return this.request("POST", "/v1/page-analytics/query", { query });
+  }
   listEvalSuites() {
     return this.request("GET", "/v1/evals/suites");
   }
@@ -690,6 +696,14 @@ var ErdoClient = class {
   deployPage(input) {
     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 });
+  }
+  getPageReview(id) {
+    return this.request("GET", `/v1/page-reviews/${encodeURIComponent(id)}`);
+  }
   updatePage(pageID, input) {
     return this.request("PUT", `/v1/pages/${encodeURIComponent(pageID)}`, input);
   }
@@ -2235,6 +2249,41 @@ pagesCmd.command("get <id>").description("Show an artifact").action(async (id) =
     fail(e);
   }
 });
+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) => {
+  try {
+    const client = new ErdoClient();
+    const started = await client.reviewPages(urls);
+    if (!opts.wait) {
+      print(started);
+      return;
+    }
+    const deadline = Date.now() + 15 * 60 * 1e3;
+    process.stderr.write("reviewing");
+    while (Date.now() < deadline) {
+      const res = await client.getPageReview(started.id);
+      if (res.status === "ready" || res.status === "failed") {
+        process.stderr.write("\n");
+        print(res);
+        return;
+      }
+      process.stderr.write(".");
+      await sleep2(5e3);
+    }
+    process.stderr.write("\n");
+    print(await client.getPageReview(started.id));
+  } 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));
+  } catch (e) {
+    fail(e);
+  }
+});
 var datasetsCmd = program.command("datasets").description("Datasets");
 datasetsCmd.command("list").description("List datasets").action(async () => {
   try {
@@ -2311,6 +2360,33 @@ datasetsCmd.command("from-integration <app>").description("Create a dataset back
     fail(e);
   }
 });
+function printAnalyticsTable(columns, rows) {
+  const cell = (v) => v === null || v === void 0 ? "" : typeof v === "object" ? JSON.stringify(v) : String(v);
+  const widths = columns.map((c, i) => Math.max(c.length, ...rows.map((r) => cell(r[i]).length), 0));
+  const line = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
+  console.log(line(columns));
+  console.log(widths.map((w) => "-".repeat(w)).join("  "));
+  for (const r of rows) console.log(line(columns.map((_, i) => cell(r[i]))));
+}
+var analytics = program.command("analytics").description("Query page analytics (how published pages perform with real visitors)");
+analytics.command("query <hogql>").description("Run a read-only HogQL query against this org's page-analytics events").option("--json", "print the raw JSON result instead of a table").action(async (hogql, opts) => {
+  try {
+    const res = await new ErdoClient().queryPageAnalytics(hogql);
+    if (opts.json) {
+      print(res);
+      return;
+    }
+    if (!res.enabled) {
+      console.log("Page analytics is not enabled for this organization \u2014 turn it on in the Erdo app, then query real traffic here.");
+      return;
+    }
+    printAnalyticsTable(res.columns, res.rows);
+    if (res.truncated) console.log(`
+(rows truncated at the cap \u2014 aggregate further or add a tighter filter/LIMIT)`);
+  } catch (e) {
+    fail(e);
+  }
+});
 var OPERATORS = ["equals", "not_equals", "greater_than", "less_than", "contains", "between"];
 function parseCondition(s) {
   const m = s.trim().match(/^(\S+)\s+(\S+)\s+([\s\S]+)$/);

package/package.json

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