@erdoai/cli 0.45.0 → 0.46.0

package/dist/index.js

@@ -287,6 +287,13 @@ var ErdoClient = class {
   queryPageAnalytics(query) {
     return this.request("POST", "/v1/page-analytics/query", { query });
   }
+  // Read which analytics destinations the org's published pages send visitor data
+  // to — the check that stops "this audience is big enough to retarget" being
+  // concluded from traffic no pixel was ever tagging. Read-only: destinations are
+  // Erdo-provisioned, never caller-set.
+  getPageTracking() {
+    return this.request("GET", "/v1/page-tracking");
+  }
   listEvalSuites() {
     return this.request("GET", "/v1/evals/suites");
   }
@@ -2397,20 +2404,57 @@ approvalsCmd.command("decide <id>").description("Approve or reject a pending app
   "--scope <scope>",
   "once (default) | always_this_job | always_this_workstream | always_org | always_user",
   "once"
-).action(async (id, opts) => {
-  try {
-    if (opts.approve === opts.reject) {
-      throw new Error("specify exactly one of --approve or --reject");
+).option(
+  "--option <n>",
+  "for standing (non-once) approvals: use the request's Nth scope option (1-based) as the policy's parameter constraints \u2014 list them with `erdo approvals list --json`",
+  (v) => parseInt(v, 10)
+).option(
+  "--constraints <json>",
+  `explicit parameter constraints for the standing policy, e.g. '{"spreadsheet_id":{"values":["..."]}}'`
+).action(
+  async (id, opts) => {
+    try {
+      if (opts.approve === opts.reject) {
+        throw new Error("specify exactly one of --approve or --reject");
+      }
+      if (opts.option !== void 0 && opts.constraints !== void 0) {
+        throw new Error("specify at most one of --option or --constraints");
+      }
+      const client = new ErdoClient();
+      let constraints;
+      if (opts.constraints !== void 0) {
+        try {
+          constraints = JSON.parse(opts.constraints);
+        } catch {
+          throw new Error(
+            `--constraints must be JSON, e.g. '{"spreadsheet_id":{"values":["abc"]}}'`
+          );
+        }
+      } else if (opts.option !== void 0) {
+        const res2 = await client.listApprovals({ status: "pending" });
+        const req = res2.requests.find((r) => r.id === id);
+        if (!req) {
+          throw new Error(`pending approval ${id} not found`);
+        }
+        const options = req.scope_options ?? [];
+        if (opts.option < 1 || opts.option > options.length) {
+          const listing = options.length ? options.map((o, i) => `  ${i + 1}. ${o.label}`).join("\n") : "  (none \u2014 pass --constraints instead)";
+          throw new Error(`--option must be 1..${options.length}; available options:
+${listing}`);
+        }
+        constraints = options[opts.option - 1].constraints;
+      }
+      const res = await client.decideApproval(id, {
+        decision: opts.approve ? "approved" : "rejected",
+        scope: opts.scope,
+        parameter_constraints: constraints
+      });
+      console.log(res.message);
+    } catch (e) {
+      fail(e);
     }
-    const res = await new ErdoClient().decideApproval(id, {
-      decision: opts.approve ? "approved" : "rejected",
-      scope: opts.scope
-    });
-    console.log(res.message);
-  } catch (e) {
-    fail(e);
   }
-});
+);
 var attnCmd = program.command("attention").description("The attention feed \u2014 digests, choices, escalations awaiting a human");
 attnCmd.command("list").description("List attention items").option("--status <status...>", "open | answered | dismissed | expired").option("--open", "shorthand for --status open").option("--engine-actions", "only engine-generated items").option("-n, --limit <n>", "max items", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).action(
   async (opts) => {
@@ -3019,7 +3063,7 @@ function printAnalyticsTable(columns, rows) {
   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)");
+var analytics = program.command("analytics").description("Page analytics \u2014 what is tracking your published pages, and how they 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);
@@ -3038,6 +3082,44 @@ analytics.command("query <hogql>").description("Run a read-only HogQL query agai
     fail(e);
   }
 });
+var TRACKING_KINDS = [
+  { kind: "session_analytics", what: "heatmaps, session replay, and the events behind `erdo analytics query`" },
+  { kind: "google_analytics", what: "GA4 measurement" },
+  { kind: "meta_pixel", what: "cookies visitors so Meta retargeting audiences can be built" }
+];
+analytics.command("tracking").description("Show which analytics destinations this org's published pages send visitor data to").option("--json", "print the raw JSON result instead of a table").action(async (opts) => {
+  try {
+    const res = await new ErdoClient().getPageTracking();
+    if (opts.json) {
+      print(res);
+      return;
+    }
+    const destinations = res.destinations ?? [];
+    const byKind = new Map(destinations.map((d) => [d.kind, d]));
+    const rows = TRACKING_KINDS.map(({ kind, what }) => {
+      const d = byKind.get(kind);
+      const status = d === void 0 ? "not configured" : d.enabled ? "on" : "configured, off";
+      return [kind, status, d?.public_id ?? "", d?.provider ?? "", what];
+    });
+    for (const d of destinations) {
+      if (!TRACKING_KINDS.some((k) => k.kind === d.kind)) {
+        rows.push([d.kind, d.enabled ? "on" : "configured, off", d.public_id ?? "", d.provider ?? "", ""]);
+      }
+    }
+    printAnalyticsTable(["kind", "status", "public id", "provider", "what it does"], rows);
+    console.log(`
+session replay input masking: ${res.mask_inputs ? "on" : "OFF \u2014 form values are recorded"}`);
+    console.log(`consent: ${res.consent}${res.consent === "required" ? " (recording waits on a consent banner, so thin volume may be the gate, not the traffic)" : ""}`);
+    if (!byKind.get("meta_pixel")?.enabled) {
+      console.log(`
+No Meta pixel is firing on these pages, so no retargeting audience is accumulating \u2014 page traffic alone does not mean those visitors can be served ads.`);
+    }
+    console.log(`
+Erdo's own page-events beacon is provisioned per page at render time and is not listed above \u2014 it records independently of every vendor here.`);
+  } catch (e) {
+    fail(e);
+  }
+});
 var OPERATORS = ["equals", "not_equals", "greater_than", "less_than", "contains", "not_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.45.0",
+  "version": "0.46.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {