@drip-apex/apex-cli 0.9.0 → 0.11.0

package/README.md

@@ -86,6 +86,16 @@ apex schema --json
 
 Use `apex` as the canonical command name. `drip` is a compatibility alias.
 
+`apex experiments list` returns code-free summaries by default, including
+`targeting_urls` and `variation_count`, without targeting objects, variations, or goals.
+Use `--full --json` for full details, including code. `--full` keeps the default table unchanged.
+Use `--fields id,test_key,name,status --json` to select top-level keys (JSON always keeps `id`),
+or `--fields status,name` to print exactly those table columns in order.
+`--fields` and `--full` can combine; invalid fields return the allowed keys.
+Existing CR-011 filters still narrow the set; these flags only select row content.
+The direct API retains its full default view; the CLI requests `view=summary`.
+Summary timestamps include `created_at` and `archived_at`; experiments have no `updated_at` field.
+
 `apex experiments list` hides archived experiments by default. Pass
 `--include-archived` to include them; archived rows display their archive date
 when the API provides `archived_at`.
@@ -129,7 +139,7 @@ including every subcommand, argument, option, and alias.
 - `apex experiments` — create, inspect, operate, and synchronize experiments.
   Use `apex experiments screenshots <id-or-slug>` to force-assign every capture, including control, to its variation server-side for deterministic screenshots. Resume a job that outlives the CLI timeout with `--job <id>`; polling continues without creating another job, and the stored job's devices and variations win, so `--devices`/`--variations` are ignored (the CLI warns). The command attaches terminal jobs to the QA run by default; use `--no-attach-qa` to opt out. Choose devices with `--devices`, filter treatments with `--variations`, and use `--json` for the signed result payload. Use `apex experiments qa evidence` with `--job`, repeatable `--file`, or `--records` to write QA evidence directly.
 - `apex push` — synchronize `.drip.config.ts` with Apex.
-- `apex preview` — open a variation QA preview.
+- `apex preview` — open a variation QA preview; `--proxy` returns a `qa_run` receipt. Its `automated_evidence_count` counts the normalized `evidenceRecords` across all evidence kinds, matching the list shown by `apex experiments qa status`.
 - `apex roadmap` — consume approved roadmap ideas and handoffs.
 - `apex harness` — develop AB Test Harness projects with live QA sessions.
 - `apex workspace` — check out, preview, and publish draft workspace files.
@@ -328,3 +338,7 @@ optimistic concurrency token.
 | --- | --- |
 | `approval` | Roadmap decision status (`proposed` without a decision), item stage, and decision's nullable `decided_at`. Top-level `status` remains the item lifecycle status. |
 | `goals` | `apex_goal_id` is the linked experiment goal or null. |
+
+QA status creates a run only when none exists. Reading an existing run never writes
+to it: `updatedAt` is its last stored mutation time, while `computedAt` is the ISO
+timestamp when the current checklist and summary were computed.

package/dist/cli.js

@@ -7112,7 +7112,7 @@ var import_node_os3 = __toESM(require("node:os"));
 // package.json
 var package_default = {
   name: "@drip-apex/apex-cli",
-  version: "0.9.0",
+  version: "0.11.0",
   license: "MIT",
   description: "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   private: false,
@@ -7762,6 +7762,8 @@ function listExperiments(creds, opts) {
   if (opts?.limit) params.set("limit", String(opts.limit));
   if (opts?.cursor) params.set("cursor", opts.cursor);
   if (opts?.includeArchived) params.set("archived", "1");
+  if (opts?.view) params.set("view", opts.view);
+  if (opts?.fields !== void 0) params.set("fields", opts.fields);
   const qs = params.toString();
   return request(creds, "GET", `/api/v1/experiments${qs ? `?${qs}` : ""}`);
 }
@@ -9639,6 +9641,7 @@ function printQaPreviewUrls(experimentId, result) {
 function printQaRun(run3) {
   console.log();
   console.log(source_default.bold(`QA run ${run3.id}`));
+  console.log(`  computedAt: ${run3.computedAt}`);
   console.log(`  Status:   ${statusBadge(run3.summary.status)}`);
   console.log(`  Required: ${run3.summary.completedRequired}/${run3.summary.required}`);
   if (run3.approvedAt) console.log(`  Approved: ${run3.approvedAt}`);
@@ -9804,16 +9807,23 @@ async function resolveExperiment(idOrSlug) {
     res.errorDetails
   );
 }
-var list = new Command("list").alias("ls").description("List experiments (archived experiments are hidden by default)").option(
+var list = new Command("list").alias("ls").description(
+  "List experiments in summary view by default; use --full for details or --fields for selected columns (archived experiments are hidden by default)"
+).option(
   "-s, --status <status>",
   "Filter by status (draft|awaiting_client_approval|changes_requested|client_approved|qa|ready_to_launch|running|paused|completed)"
-).option("-n, --limit <n>", "Max results", "20").option("--include-archived", "Include archived experiments").action(async function action3(opts) {
+).option("-n, --limit <n>", "Max results", "20").option("--include-archived", "Include archived experiments").option("--full", "Return full experiment details instead of the default summary").option(
+  "--fields <list>",
+  "Comma-separated fields to return and table columns in order (JSON always keeps id)"
+).action(async function action3(opts) {
   const creds = requireCredentials();
   const spinner = await createSpinner("Fetching experiments...");
   const res = await listExperiments(creds, {
     status: opts.status,
     limit: parseInt(opts.limit, 10),
-    includeArchived: opts.includeArchived
+    includeArchived: opts.includeArchived,
+    view: opts.full ? "full" : "summary",
+    fields: opts.fields
   });
   if (!res.ok) {
     spinner?.fail("Failed to fetch experiments");
@@ -9826,18 +9836,32 @@ var list = new Command("list").alias("ls").description("List experiments (archiv
       console.log(source_default.dim("No experiments found."));
       return;
     }
-    printTable(
-      ["NAME", "SLUG", "STATUS", "ARCHIVED", "TRAFFIC", "CREATED"],
-      experiments.map((e) => [
-        e.name.slice(0, 40),
-        e.slug ?? source_default.dim("-"),
-        statusBadge(e.status),
-        e.archived_at ? formatDate(e.archived_at) : source_default.dim("-"),
-        `${(e.traffic_allocation * 100).toFixed(0)}%`,
-        formatDate(e.created_at)
-      ]),
-      [40, 25, 12, 15, 8, 15]
-    );
+    if (opts.fields !== void 0) {
+      const fields3 = [
+        ...new Set(opts.fields.split(",").map((field) => field.trim()))
+      ];
+      printTable(
+        fields3.map((field) => field.toUpperCase()),
+        experiments.map(
+          (experiment) => fields3.map((field) => {
+            const value = experiment[field];
+            return value == null ? "-" : typeof value === "object" ? JSON.stringify(value) : String(value);
+          })
+        )
+      );
+    } else
+      printTable(
+        ["NAME", "SLUG", "STATUS", "ARCHIVED", "TRAFFIC", "CREATED"],
+        experiments.map((e) => [
+          e.name.slice(0, 40),
+          e.slug ?? source_default.dim("-"),
+          statusBadge(e.status),
+          e.archived_at ? formatDate(e.archived_at) : source_default.dim("-"),
+          `${(e.traffic_allocation * 100).toFixed(0)}%`,
+          formatDate(e.created_at)
+        ]),
+        [40, 25, 12, 15, 8, 15]
+      );
     if (res.data.pagination.has_more) {
       console.log(source_default.dim(`
   (more results available)`));
@@ -10826,7 +10850,9 @@ var applyFilesystem = new Command("apply").option("--sync", "Refresh local autho
     fail(this, error instanceof Error ? error.message : String(error));
   }
 });
-var qaStatus = new Command("status").description("Show or create the latest experiment QA run").argument(
+var qaStatus = new Command("status").description(
+  "Show the latest experiment QA run (creates one only when none exists; reads never change updatedAt)"
+).argument(
   "[folder-or-id]",
   "Experiment filesystem folder, ID, slug, or test key (for example BIO-085)",
   "."
@@ -11791,7 +11817,9 @@ var pushCommand = new Command("push").description("Push experiment definitions f
 
 // src/commands/preview.ts
 init_source();
-var previewCommand = new Command("preview").description("Open QA preview URL for an experiment variation").argument("<id-or-slug>", "Experiment ID or slug").argument("[variation-id]", "Variation ID (defaults to first non-control)").option("--store-url <url>", "Override experiment store_url (target website URL)").option("--proxy", "Create an artifact-injecting proxy preview").option("--ttl <hours>", "Proxy preview lifetime in hours (1-168)").option("--no-open", "Print URL instead of opening browser").action(
+var previewCommand = new Command("preview").description(
+  "Open QA preview URL for an experiment variation; proxy previews return a QA run receipt"
+).argument("<id-or-slug>", "Experiment ID or slug").argument("[variation-id]", "Variation ID (defaults to first non-control)").option("--store-url <url>", "Override experiment store_url (target website URL)").option("--proxy", "Create an artifact-injecting proxy preview").option("--ttl <hours>", "Proxy preview lifetime in hours (1-168)").option("--no-open", "Print URL instead of opening browser").action(
   async (idOrSlug, variationId, opts) => {
     const creds = requireCredentials();
     if (opts?.proxy) {
@@ -11819,6 +11847,9 @@ var previewCommand = new Command("preview").description("Open QA preview URL for
       const data = created.data;
       output(previewCommand, data, () => {
         console.log(source_default.cyan(data.preview_url));
+        console.log(
+          data.qa_run.created ? `QA run ${data.qa_run.id} created` : `QA run ${data.qa_run.id} refreshed (${data.qa_run.automated_evidence_count} automated evidence records)`
+        );
         const expiresAt = new Date(data.expires_at);
         const remainingMs = expiresAt.getTime() - Date.now();
         const value = remainingMs < 864e5 ? Math.max(1, Math.round(remainingMs / 36e5)) : Math.round(remainingMs / 864e5);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drip-apex/apex-cli",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "license": "MIT",
   "description": "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   "private": false,