@erdoai/cli 0.58.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.
@@ -2077,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(
@@ -3105,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];

package/package.json

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