@erdoai/cli 0.33.0 → 0.35.0

package/dist/index.js

@@ -241,6 +241,25 @@ var ErdoClient = class {
   setAutonomyMode(mode) {
     return this.request("PUT", "/v1/autonomy-mode", { mode });
   }
+  // --- Manager accounts: operate many client (managed) orgs with ONE manager key ---
+  // The manager is your active org; you must be an admin/owner of it. A managed org
+  // is a client tenant you provision and operate. The manager key (createManagerKey)
+  // is a single credential that acts inside any managed org via X-Organization-ID.
+  listManagedOrganizations() {
+    return this.request("GET", "/v1/managed-organizations");
+  }
+  createManagedOrganization(input) {
+    return this.request("POST", "/v1/managed-organizations", input);
+  }
+  revokeManagedOrganization(slug) {
+    return this.request(
+      "DELETE",
+      `/v1/managed-organizations/${encodeURIComponent(slug)}`
+    );
+  }
+  createManagerKey() {
+    return this.request("POST", "/v1/manager-key");
+  }
   // 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.
@@ -488,6 +507,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 +787,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)}`);
@@ -1221,6 +1258,61 @@ org.command("autonomy [mode]").description("Show or set the org's engine-autonom
     fail(e);
   }
 });
+var managed = org.command("managed").description("Operate client orgs via a manager account");
+managed.command("list").description("List the client orgs your org manages").action(async () => {
+  try {
+    const { organizations } = await new ErdoClient().listManagedOrganizations();
+    if (organizations.length === 0) {
+      console.log("No managed orgs. Create one with: erdo org managed create --name <name>");
+      return;
+    }
+    for (const o of organizations) {
+      console.log(`${o.slug || "-"}	${o.name}	${o.role}	${o.id}`);
+    }
+  } catch (e) {
+    fail(e);
+  }
+});
+managed.command("create").description("Provision a new client org managed by your org").requiredOption("--name <name>", "display name for the new managed org").option("--slug <slug>", "desired slug (a unique suffix is appended if it collides)").action(async (opts) => {
+  try {
+    const o = await new ErdoClient().createManagedOrganization({ name: opts.name, slug: opts.slug });
+    console.log(`Created managed org: ${o.name}`);
+    console.log(`slug: ${o.slug}
+id: ${o.id}`);
+    process.stderr.write(
+      `Operate it with the manager key by passing --org ${o.slug} on any command (e.g. erdo --org ${o.slug} datasets list).
+`
+    );
+  } catch (e) {
+    fail(e);
+  }
+});
+managed.command("revoke <slug>").description("Stop managing a client org (removes access; keeps an audit record)").action(async (slug) => {
+  try {
+    await new ErdoClient().revokeManagedOrganization(slug);
+    console.log(`revoked: ${slug}`);
+  } catch (e) {
+    fail(e);
+  }
+});
+managed.command("key").description("Mint (or rotate) your manager key \u2014 one credential for every managed org; shown ONCE").action(async () => {
+  try {
+    const res = await new ErdoClient().createManagerKey();
+    process.stderr.write(
+      "Store this manager key now \u2014 it is shown only once and cannot be retrieved again.\n"
+    );
+    console.log(res.token);
+    process.stderr.write(
+      `
+token id: ${res.token_id}
+expires: ${res.expires_at}
+This key operates every org you manage; target one with X-Organization-ID (or \`erdo --org <slug> \u2026\`). Running this again rotates the key.
+`
+    );
+  } catch (e) {
+    fail(e);
+  }
+});
 var tokenCmd = program.command("token").description("Manage your API tokens (account-level credentials)");
 tokenCmd.command("create").description("Mint a new API token; the secret is printed ONCE").requiredOption("--name <name>", "a label for the token").option("--expires-days <n>", "days until expiry (default: 30)", (v) => parseInt(v, 10)).option("--org <idOrSlug>", "the token's default org (defaults to your active org; must be one you belong to)").action(async (opts) => {
   try {
@@ -2224,6 +2316,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 +2559,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.35.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {