@erdoai/cli 0.57.0 → 0.59.0

package/dist/index.js

@@ -579,6 +579,14 @@ var ErdoClient = class {
       input
     );
   }
+  // --- page feedback ---
+  // Structured client page-feedback intake. Each item names its page by
+  // experiment_slug + variant_key and mints a 'defect' observation (judge_slug
+  // human:<you>) on the ledger with the feedback text stored verbatim as the
+  // reason — the same channel respondAttentionItem's defects flag writes to.
+  recordPageFeedback(items) {
+    return this.request("POST", "/v1/page-feedback", { items });
+  }
   // --- activity feed ---
   // The unified, ranked, read-only feed. It defaults to attention items,
   // approvals, and workstream events; catalog and execution history are opt-in.
@@ -1385,6 +1393,18 @@ function timedOutMessage(threadID) {
 function print(value) {
   console.log(JSON.stringify(value, null, 2));
 }
+function printPageReview(review) {
+  if (!review) return;
+  if (!review.reviewed) {
+    console.error(`review: not run${review.reason ? ` (${review.reason})` : ""}`);
+    return;
+  }
+  console.error(`review: ${review.summary || `${review.issues?.length ?? 0} issue(s)`}`);
+  for (const issue of review.issues || []) {
+    console.error(`  [${issue.severity}/${issue.category}] ${issue.description}`);
+    if (issue.suggestion) console.error(`      fix: ${issue.suggestion}`);
+  }
+}
 function printAlignedTable(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));
@@ -2065,7 +2085,7 @@ expCmd.command("create").description("Create an experiment with its variants, ev
     }
   }
 );
-expCmd.command("observations <slug>").description("Read an experiment's observation log (metric reads / decisions / actions / judge forecasts)").option("--variant <key>", "filter to one variant").option("--type <type>", "metric_read, decision_check, action, prediction, comparison").option("--judge <slug>", "filter to one judge's forecasts within this experiment").option("-n, --limit <n>", "max rows", (v) => parseInt(v, 10)).action(
+expCmd.command("observations <slug>").description("Read an experiment's observation log (metrics / decisions / actions / judge forecasts / defects)").option("--variant <key>", "filter to one variant").option("--type <type>", "metric_read, decision_check, action_taken, prediction, comparison, defect").option("--judge <slug>", "filter to one judge's forecasts within this experiment").option("-n, --limit <n>", "max rows", (v) => parseInt(v, 10)).action(
   async (slug, opts) => {
     try {
       print(
@@ -3093,6 +3113,64 @@ attnCmd.command("respond <id>").description(
     }
   }
 );
+var pageFeedbackCmd = program.command("page-feedback").description(
+  "Structured client page-feedback intake \u2014 mints defect observations bound to a page's experiment variant"
+);
+pageFeedbackCmd.command("record").description(
+  "Record one or more page-feedback items. Each item's feedback text is stored VERBATIM as the resulting defect observation's reason \u2014 no summarizing or rewriting happens here. Use --experiment/--variant/--feedback for a single item, or --items for a whole round."
+).option("--experiment <slug>", "experiment slug or uuid the page belongs to (single-item form)").option("--variant <key>", "the page variant this feedback is about (single-item form)").option(
+  "--feedback <text>",
+  "the client's own words, stored byte-for-byte as supplied (single-item form)"
+).option(
+  "--image-key <key>",
+  "optional bucket_key from a prior image upload, anchoring this item to an image (single-item form)"
+).option(
+  "--items <json>",
+  `a whole feedback round as JSON, or @path to a JSON file: '[{"experiment_slug":"...","variant_key":"...","feedback":"..."}]'`
+).action(
+  async (opts) => {
+    try {
+      const singleGiven = opts.experiment !== void 0 || opts.variant !== void 0 || opts.feedback !== void 0 || opts.imageKey !== void 0;
+      if (opts.items !== void 0 && singleGiven) {
+        fail(
+          new Error(
+            "provide either --items or the single-item flags (--experiment/--variant/--feedback/--image-key), not both"
+          )
+        );
+      }
+      let items;
+      if (opts.items !== void 0) {
+        let parsed;
+        try {
+          parsed = JSON.parse(readMaybeFile(opts.items));
+        } catch {
+          throw new Error(
+            `--items must be valid JSON (or @path to a JSON file), e.g. '[{"experiment_slug":"...","variant_key":"...","feedback":"..."}]'`
+          );
+        }
+        if (!Array.isArray(parsed)) {
+          throw new Error("--items must be a JSON array of {experiment_slug, variant_key, feedback} objects");
+        }
+        items = parsed;
+      } else {
+        if (!opts.experiment || !opts.variant || !opts.feedback) {
+          throw new Error("provide --items, or all of --experiment, --variant, --feedback");
+        }
+        items = [
+          {
+            experiment_slug: opts.experiment,
+            variant_key: opts.variant,
+            feedback: opts.feedback,
+            image_bucket_key: opts.imageKey
+          }
+        ];
+      }
+      print(await new ErdoClient().recordPageFeedback(items));
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 function activityLine(it) {
   const handle = it.slug || it.id;
   const parts = [it.title || it.type];
@@ -3397,7 +3475,10 @@ pagesCmd.command("update <id>").description(
 ).option("--title <title>", "new title").option("--html <htmlOr@file>", "HTML (or @path to a file)").option("--js <jsOr@file>", "JS/JSX (or @path)").option("--css <cssOr@file>", "CSS (or @path)").option(
   "--meta-title <title>",
   'new public SEO title (omit to keep current; pass "" to clear back to the default)'
-).option("--meta-description <description>", 'new public SEO description (omit to keep current; pass "" to clear)').option("--datasets <csv>", 'replacement read-dataset slugs ("[]" clears)').option("--writable-datasets <csv>", 'replacement writable-dataset slugs ("[]" clears)').option("--kv <csv>", 'replacement read KV-store slugs ("[]" clears)').option("--writable-kv <csv>", 'replacement writable KV-store slugs ("[]" clears)').option("--public", "make the page publicly viewable").option("--private", "make the page private").action(
+).option("--meta-description <description>", 'new public SEO description (omit to keep current; pass "" to clear)').option("--datasets <csv>", 'replacement read-dataset slugs ("[]" clears)').option("--writable-datasets <csv>", 'replacement writable-dataset slugs ("[]" clears)').option("--kv <csv>", 'replacement read KV-store slugs ("[]" clears)').option("--writable-kv <csv>", 'replacement writable KV-store slugs ("[]" clears)').option("--public", "make the page publicly viewable").option("--private", "make the page private").option(
+  "--request-review",
+  "ask the judge lenses to review the page after this update and report findings -- for material edits to a LIVE page (layout, forms/CTA, legal/compliance copy, restructured sections), not cosmetic tweaks. First builds and full rewrites are already reviewed automatically"
+).action(
   async (id, opts) => {
     try {
       const res = await new ErdoClient().updatePage(id, {
@@ -3411,10 +3492,12 @@ pagesCmd.command("update <id>").description(
         writable_dataset_slugs: grantList(opts.writableDatasets),
         kv_slugs: grantList(opts.kv),
         writable_kv_slugs: grantList(opts.writableKv),
-        public: opts.public ? true : opts.private ? false : void 0
+        public: opts.public ? true : opts.private ? false : void 0,
+        request_review: !!opts.requestReview
       });
       console.log(`${res.id}	${res.public_url || res.url}`);
       if (res.warning) console.error(`warning: ${res.warning}`);
+      printPageReview(res.review);
     } catch (e) {
       fail(e);
     }

package/package.json

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