@drip-apex/apex-cli 0.11.0 → 0.12.0

package/README.md

@@ -342,3 +342,15 @@ optimistic concurrency token.
 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.
+
+### Decision latency
+
+`apex tracking latency <experiment-id-or-key> [--days <1..30>] [--qa-session <id>] [--json]`
+compares forced-preview and natural decision latency before launch. The default
+window is seven days. The table shows sample counts, decision p50/p95/p99,
+config-fetch p50/p95 (milliseconds), and inline/cache/network/none counts.
+JSON output includes the API body in the standard envelope and assignment-ready
+percentiles. Fewer than five measured samples have null percentiles. Natural
+loads are shop-wide non-QA loads without forced IDs; a QA-session bucket can
+overlap forced loads. Analytics failures return errors. Preload and anti-flicker
+changes remain under evaluation pending the first report.

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.11.0",
+  version: "0.12.0",
   license: "MIT",
   description: "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   private: false,
@@ -7985,6 +7985,11 @@ function trackingEventProperties(event) {
   if (event.goal_id != null) properties.goalId = event.goal_id;
   return properties;
 }
+function getDecisionLatency(creds, experimentId, opts) {
+  const params = new URLSearchParams({ experiment_id: experimentId, days: String(opts.days) });
+  if (opts.qaSessionId) params.set("qa_session_id", opts.qaSessionId);
+  return request(creds, "GET", `/api/v1/tracking/latency?${params}`);
+}
 function verifyTracking(creds, opts) {
   const params = new URLSearchParams();
   if (opts?.minutes) params.set("minutes", String(opts.minutes));
@@ -13096,6 +13101,63 @@ trackingCommand.command("verify").description("Verify live tracking events for t
     }
   });
 });
+trackingCommand.command("latency").description("Measure forced-preview versus natural decision latency before launch").argument("<experiment-id-or-key>", "Experiment ID or test key").option("--days <n>", "Lookback window in days (1\u201330)", "7").option("--qa-session <id>", "Include a QA session bucket").action(async function(experimentId, opts) {
+  const days = Number(opts.days);
+  if (!Number.isInteger(days) || days < 1 || days > 30) {
+    fail(this, "days must be an integer from 1 to 30", classifyStatus(400));
+  }
+  const result = await getDecisionLatency(requireCredentials(), experimentId, {
+    days,
+    qaSessionId: opts.qaSession
+  });
+  if (!result.ok || !result.data) {
+    fail(
+      this,
+      result.error ?? "Failed to read decision latency",
+      classifyStatus(result.status),
+      result.errorDetails
+    );
+  }
+  const summary = result.data;
+  output(this, summary, () => {
+    const buckets = [
+      ["forced", summary.forced],
+      ["natural", summary.natural],
+      ...summary.qa_session ? [["qa_session", summary.qa_session]] : []
+    ];
+    const ms = (value) => value === null ? "-" : String(Math.round(value));
+    printTable(
+      [
+        "Bucket",
+        "Samples",
+        "Decision p50",
+        "p95",
+        "p99",
+        "Config p50",
+        "p95",
+        "inline/cache/network/none"
+      ],
+      buckets.map(([name, bucket]) => [
+        name,
+        String(bucket.samples),
+        ms(bucket.decision_latency_ms.p50),
+        ms(bucket.decision_latency_ms.p95),
+        ms(bucket.decision_latency_ms.p99),
+        ms(bucket.config_fetch_ms.p50),
+        ms(bucket.config_fetch_ms.p95),
+        [
+          bucket.config_sources.inline,
+          bucket.config_sources.cache,
+          bucket.config_sources.network,
+          bucket.config_sources.none
+        ].join("/")
+      ])
+    );
+    console.log(
+      "Times in ms. Fewer than 5 measured samples: -. Preload/anti-flicker position: under evaluation."
+    );
+  });
+});
 
 // src/commands/goals.ts
 init_source();

package/package.json

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