@drip-apex/apex-cli 0.9.0 → 0.10.0

package/README.md

@@ -129,7 +129,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 +328,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.10.0",
   license: "MIT",
   description: "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   private: false,
@@ -9639,6 +9639,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}`);
@@ -10826,7 +10827,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 +11794,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 +11824,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.10.0",
   "license": "MIT",
   "description": "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   "private": false,