@drip-apex/apex-cli 0.10.0 → 0.12.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`.
@@ -332,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.10.0",
+  version: "0.12.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}` : ""}`);
 }
@@ -7983,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));
@@ -9805,16 +9812,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");
@@ -9827,18 +9841,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)`));
@@ -13073,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.10.0",
+  "version": "0.12.0",
   "license": "MIT",
   "description": "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
   "private": false,