@drip-apex/apex-cli 0.16.0 → 0.18.0

package/AGENTS.md

@@ -71,6 +71,8 @@ the first writes: `apex experiments create`, `apex goals create`,
 - Stale workspace or filesystem: pull fresh files, reapply your edits, and plan again.
 - Server limit errors: read the JSON error details; Apex includes server-owned limits when available.
 
+- Windows text corruption: use UTF-8 console settings; Apex repairs reversible Windows-1252 arguments and warns on stderr for U+FFFD. Set `APEX_ARGV_ENCODING=off` to disable repair.
+
 ## Platform Shop Administration
 
 - `apex admin shops archive <shopId>` archives a shop; headless callers must

package/README.md

@@ -191,13 +191,15 @@ including every subcommand, argument, option, and alias.
 - `apex simulate` — simulate data-layer triggers without emitting events.
 - `apex experiments status [folder-or-id]` — read context, file versions, QA, and handover next steps without writing. Defaults to the current pulled folder.
 - `apex experiments` — create, inspect, operate, and synchronize experiments.
+- `apex results` — inspect, preview, and import historical CSV or JSON test results.
   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 commerce` — look up Shopify products, live prices and costs for commerce drafts.
 - `apex push` — synchronize `.drip.config.ts` with Apex.
 - `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.
-- `apex goals` — manage conversion and revenue goals.
+- `apex goals` — manage conversion and revenue goals. Create/update accept `--page-id <id>` (UUID only, no lookup) or `--page <id-or-key>` (keys need `pages:read` for lookup); use one option.
 - `apex flags` — manage feature flags.
 - `apex personalizations` — manage personalization deliveries.
 - `apex backlog` — manage experiment backlog items.
@@ -220,7 +222,7 @@ including every subcommand, argument, option, and alias.
 ### Shop configuration and operations
 
 - `apex external-pixels` — manage external pixel snippets.
-- `apex assets` — manage uploaded assets.
+- `apex assets` — manage uploaded assets. Upload returns `delivery_url`; embed that permanent URL in variation code. `public_url` expires after 300 seconds. Delivery is anonymous once the referencing experiment or snippet is published, and resolves through the owning shop's dashboard session or a QA preview before that. Only the absolute https form is recognized as an owned reference; protocol-relative or http forms are not granted at publication.
 - `apex landing-pages` — build landing pages with your own tools, then apply, preview, deploy and roll them back.
 - `apex brand` — manage brand context.
 - `apex shops` — manage shops and active-shop context.
@@ -238,6 +240,9 @@ command inventory:
 | `apex admin customers create` | Create internal, demo or dogfood accounts with a platform user key. Requires `--name`, `--category`, an 8 to 500 character `--reason`, and `--confirm`. |
 | `apex admin shops archive <shopId>` | Archive a shop and disable Apex delivery; use `--force` in non-interactive environments. |
 | `apex admin shops restore <shopId>` | Restore an archived shop while leaving its runtime kill switch unchanged. |
+| `apex admin shops settings list --shop <uuid-or-domain>` | Read every registered per-shop setting, value, override and group with a platform user API key. |
+| `apex admin shops settings get --shop <uuid-or-domain> --key <key>` | Read one setting; unknown keys list the available registry keys. |
+| `apex admin shops settings set --shop <uuid-or-domain> --key <key> --value <value>` | Resolve and pin the shop, then make an audited write. Booleans accept on/off/true/false; numbers must be finite; null clears nullable settings. Sensitive writes require `--confirm`; optional `--reason` and `--expected-version` preserve audit context and concurrency. |
 
 ## Landing pages built outside Apex
 
@@ -521,6 +526,27 @@ latest/minimum policy is cached for seven days, so offline commands still enforc
 known floor. `APEX_NO_UPDATE_CHECK=1` disables the npm lookup and optional update
 notice, but never hides a required server-floor upgrade.
 
+### Windows: UTF-8 arguments
+
+A Windows console or launcher can decode UTF-8 as Windows-1252, turning `A – B · C`
+into `A – B · C`. On Windows, Apex automatically repairs reversible argument
+values at startup and writes a note to stderr. Set `APEX_ARGV_ENCODING=off` to
+keep arguments unchanged, or `APEX_ARGV_ENCODING=repair` to enable repair on
+another platform.
+
+Use UTF-8 in PowerShell:
+
+```powershell
+[Console]::InputEncoding = [Console]::OutputEncoding = [Text.Encoding]::UTF8
+```
+
+For Git Bash, set `LANG=C.UTF-8` and run `chcp 65001`.
+
+A replacement character (`�`, U+FFFD) means the shell already lost a character.
+Apex sends that value as given and warns on stderr. It also warns when stored
+experiment names, descriptions, variation names, or goal names contain U+FFFD.
+These notes leave JSON stdout unchanged.
+
 ## Usage telemetry
 
 Authenticated invocations send a process invocation ID, full command path, explicitly set
@@ -578,3 +604,7 @@ or `--claim-shop <UUID>`, exclusively. `woo` maps to `woocommerce` and `other` t
 `custom`. `--owner <email>` sends an owner invitation and requires a store;
 accounts without a store have no invitations. Output includes the organization ID,
 store ID (or null), invitation results and partial delivery status.
+
+## Import past results
+
+Upload CSV or JSON exports with `apex results import --file results.csv --dry-run`. Apex suggests column and outcome-value mappings from the file; use repeated `--map 'Column=field'` and `--outcome-value 'Source value=won|lost|inconclusive'` overrides, then pass `--yes` for non-interactive confirmation. Files are inspected and previewed before any rows are written. `--source <name>` applies to the confirmed rows; the preview shows the uploaded file name.