@erdoai/cli 0.37.0 → 0.38.0

package/dist/index.js

@@ -523,6 +523,28 @@ var ErdoClient = class {
       `/v1/activity/feed${qs ? `?${qs}` : ""}`
     );
   }
+  // --- org history ledger ---
+  // The append-only org history: consequential actions (approvals decided, pages
+  // published, permissions granted/revoked, flag changes, membership changes)
+  // with full actor attribution. Read-only, newest-first. since/until are
+  // RFC3339; verbs and resource are pre-resolved by the caller.
+  listActivityHistory(params) {
+    const q = new URLSearchParams();
+    if (params?.since) q.set("since", params.since);
+    if (params?.until) q.set("until", params.until);
+    if (params?.verbs) q.set("verbs", params.verbs);
+    if (params?.resource_type) q.set("resource_type", params.resource_type);
+    if (params?.resource_id) q.set("resource_id", params.resource_id);
+    if (params?.actor_user_id) q.set("actor_user_id", params.actor_user_id);
+    if (params?.actor_kind) q.set("actor_kind", params.actor_kind);
+    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/activity/history${qs ? `?${qs}` : ""}`
+    );
+  }
   // --- knowledge review queue ---
   listReviewItems(params) {
     const q = new URLSearchParams();
@@ -2398,6 +2420,140 @@ program.command("activity").alias("feed").description(
     }
   }
 );
+function parseWhen(v) {
+  const dur = /^(\d+)\s*([smhdw])$/.exec(v.trim());
+  if (dur) {
+    const n = parseInt(dur[1], 10);
+    const unitMs = {
+      s: 1e3,
+      m: 6e4,
+      h: 36e5,
+      d: 864e5,
+      w: 6048e5
+    };
+    return new Date(Date.now() - n * unitMs[dur[2]]).toISOString();
+  }
+  const t = Date.parse(v);
+  if (Number.isNaN(t)) {
+    throw new Error(`can't parse time "${v}" \u2014 use a duration like 2h/3d or an RFC3339 timestamp`);
+  }
+  return new Date(t).toISOString();
+}
+function shortId(id) {
+  return id.length > 10 ? `${id.slice(0, 8)}\u2026` : id;
+}
+function hhmm(iso) {
+  const d = new Date(iso);
+  if (Number.isNaN(d.getTime())) return "??:??";
+  const h = String(d.getHours()).padStart(2, "0");
+  const m = String(d.getMinutes()).padStart(2, "0");
+  return `${h}:${m}`;
+}
+function historyActor(e) {
+  switch (e.actor_kind) {
+    case "agent":
+      return e.agent_key || "an agent";
+    case "system":
+      return "Erdo (system)";
+    case "user":
+      return e.actor_user_id ? shortId(e.actor_user_id) : "a user";
+    case "api_token":
+      return "an API token";
+    case "scoped_token":
+      return "a scoped token";
+    default:
+      return e.actor_kind || "someone";
+  }
+}
+function historyResource(e) {
+  if (e.resource_title) return e.resource_title;
+  if (e.resource_type && e.resource_id) return `${e.resource_type}/${shortId(e.resource_id)}`;
+  return e.resource_type || "";
+}
+function historySentence(e) {
+  const res = historyResource(e);
+  const summary = (e.summary || "").replace(/\s+/g, " ").trim();
+  const head = [historyActor(e), summary].filter(Boolean).join(" ");
+  return res ? `${head} \u2014 ${res}` : head;
+}
+function historyAuthMarker(e) {
+  if (e.authorized_by_approval_id) {
+    return ` \xB7 authorized by approval ${shortId(e.authorized_by_approval_id)}`;
+  }
+  if (e.actor_kind === "agent" || e.actor_kind === "system") return " \xB7 autonomous";
+  return "";
+}
+function renderHistory(events) {
+  const order = [];
+  const groups = /* @__PURE__ */ new Map();
+  let standalone = 0;
+  for (const e of events) {
+    const key = e.authorized_by_approval_id || e.run_id || `__solo_${standalone++}`;
+    if (!groups.has(key)) {
+      groups.set(key, []);
+      order.push(key);
+    }
+    groups.get(key).push(e);
+  }
+  for (const key of order) {
+    const group = groups.get(key);
+    const ordered = [...group].sort(
+      (a, b) => Date.parse(a.occurred_at) - Date.parse(b.occurred_at)
+    );
+    const [head, ...rest] = ordered;
+    console.log(`${hhmm(head.occurred_at)}  ${historySentence(head)}${historyAuthMarker(head)}`);
+    for (const c of rest) {
+      console.log(`       ${hhmm(c.occurred_at)}  ${historySentence(c)}`);
+    }
+  }
+}
+program.command("history").description("The org history \u2014 who did what, when, under whose authority").option("--since <when>", "start of the window: a duration (2h, 3d) or RFC3339 (default 24h)", "24h").option("--until <when>", "end of the window: a duration or RFC3339 timestamp").option("--actor-kind <kind>", "user | agent | system | api_token | scoped_token").option("--actor <user-id>", "only actions by this user id").option("--resource <type:id>", "only actions on this resource, e.g. page:<id>").option("--verb <v>", "comma-separated verbs, e.g. approval.decided,page.published").option("-n, --limit <n>", "max events (default 50, max 200)", (v) => parseInt(v, 10)).option("--json", "raw events JSON").action(
+  async (opts) => {
+    try {
+      const params = {};
+      params.since = parseWhen(opts.since || "24h");
+      if (opts.until) params.until = parseWhen(opts.until);
+      if (opts.actorKind) params.actor_kind = opts.actorKind;
+      if (opts.actor) params.actor_user_id = opts.actor;
+      if (opts.verb) params.verbs = opts.verb;
+      if (opts.limit) params.limit = opts.limit;
+      if (opts.resource) {
+        const idx = opts.resource.indexOf(":");
+        if (idx === -1) {
+          throw new Error(`--resource must be <type:id>, e.g. page:<id> (got "${opts.resource}")`);
+        }
+        params.resource_type = opts.resource.slice(0, idx);
+        params.resource_id = opts.resource.slice(idx + 1);
+      }
+      const res = await new ErdoClient().listActivityHistory(params);
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      const events = res.events ?? [];
+      if (events.length === 0) {
+        const filters = [
+          `since ${opts.since || "24h"}`,
+          opts.until ? `until ${opts.until}` : "",
+          opts.actorKind ? `actor-kind ${opts.actorKind}` : "",
+          opts.actor ? `actor ${opts.actor}` : "",
+          opts.resource ? `resource ${opts.resource}` : "",
+          opts.verb ? `verb ${opts.verb}` : ""
+        ].filter(Boolean).join(", ");
+        console.log(`No history for: ${filters}.`);
+        console.log(
+          "History is append-only and starts when the ledger was enabled for this org \u2014 earlier actions aren't recorded here."
+        );
+        return;
+      }
+      renderHistory(events);
+      console.log(`
+${events.length} event${events.length === 1 ? "" : "s"}.`);
+    } 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"
 );

package/package.json

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