@drip-apex/apex-cli 0.13.0 → 0.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +45 -1
- package/README.md +71 -0
- package/dist/cli.js +1958 -651
- package/package.json +1 -1
- package/skills/apex-cli/SKILL.md +13 -0
package/package.json
CHANGED
package/skills/apex-cli/SKILL.md
CHANGED
|
@@ -15,6 +15,17 @@ Prefer JSON output. When stdout is piped, Apex emits JSON by default. Stdout the
|
|
|
15
15
|
carries exactly one JSON document; `data` is the API response body as returned
|
|
16
16
|
(lists at `.data.data[]`), and API failures carry the API error body in `error.api`.
|
|
17
17
|
|
|
18
|
+
## Choosing a workflow
|
|
19
|
+
|
|
20
|
+
The default loop for agents building or editing a test is `apex experiments pull`, edit supported files, `apex experiments plan`, `apex experiments apply`, then `apex experiments qa status`.
|
|
21
|
+
|
|
22
|
+
| Workflow | Use when | What it writes | Do not use when |
|
|
23
|
+
| --- | --- | --- | --- |
|
|
24
|
+
| `apex push` | Syncing config-as-code goals, targeting, and flags by slug. | Server configuration declared in `.drip.config.ts`. | Editing one test's variation files or QA state. |
|
|
25
|
+
| `apex experiments pull/plan/apply` | An agent is building or editing a test. This is the default. | Supported experiment files and server draft state after review of the plan. | You need a live operator code workbench. |
|
|
26
|
+
| `apex workspace` | An operator needs a live-preview draft for one variation. | Workspace draft files and published draft variation code. | You need the default full-experiment agent loop. |
|
|
27
|
+
| `apex harness` | An external `ab-harness` project needs build and QA integration. | External harness project artifacts and QA sessions. | Apex owns the experiment files directly. |
|
|
28
|
+
|
|
18
29
|
## Zero-Experiment Shop Bootstrap
|
|
19
30
|
|
|
20
31
|
CLI-only bootstrap is supported for a fresh shop before any experiments exist.
|
|
@@ -33,6 +44,8 @@ apex experiments pull <id-or-slug> --out <folder>
|
|
|
33
44
|
apex experiments plan <folder> --json
|
|
34
45
|
apex experiments apply <folder> --json
|
|
35
46
|
apex experiments qa status <folder> --json
|
|
47
|
+
# Before handover, inspect context, versions, and outstanding QA without writing:
|
|
48
|
+
apex experiments status <folder> --json
|
|
36
49
|
```
|
|
37
50
|
|
|
38
51
|
Edit only supported experiment files. Never hand-edit `qa.json` or `launch.json`.
|