@capxul/cli 4.20.0-beta.1 → 4.20.0-beta.3

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.
Files changed (4) hide show
  1. package/README.md +20 -4
  2. package/dist/main.mjs +1674 -356
  3. package/dist/main.mjs.map +1 -1
  4. package/package.json +3 -3
package/README.md CHANGED
@@ -14,7 +14,9 @@ capxul telemetry enable --json
14
14
  capxul doctor --online --timeout-ms 30000 --json
15
15
  ```
16
16
 
17
- Help, version, and completion do not read configuration or contact a server.
17
+ Help and version do not require application credentials or a working backend.
18
+ They use the same observation policy as ordinary commands. Shell completion
19
+ machinery and collection controls send no observation records.
18
20
  `doctor` checks local configuration unless `--online` is present. An online
19
21
  check uses the public Capxul SDK and verifies the backend response nonce.
20
22
  It does not authenticate a person or submit a transaction.
@@ -26,15 +28,29 @@ It does not authenticate a person or submit a transaction.
26
28
  | `CAPXUL_CLI_HOME` | Directory for global CLI settings. Defaults to `$XDG_CONFIG_HOME/capxul/cli`, or `$HOME/.config/capxul/cli`. |
27
29
  | `CAPXUL_PUBLISHABLE_KEY` | Application publishable key, required for an online check. |
28
30
  | `CAPXUL_BOOTSTRAP_URL` | Bootstrap origin. Defaults to `https://api.staging.capxul.com`. Convex Cloud origins are rejected. |
29
- | `CAPXUL_POSTHOG_HOST` | PostHog ingestion origin. |
30
- | `CAPXUL_POSTHOG_PROJECT_TOKEN` | Project ingestion token. Both PostHog variables are required for export. |
31
+ | `CAPXUL_POSTHOG_HOST` | Optional development override for the built-in public PostHog ingestion origin. |
32
+ | `CAPXUL_POSTHOG_PROJECT_TOKEN` | Optional development override for the built-in public project ingestion token. |
31
33
  | `CAPXUL_TELEMETRY_DISABLED` | Set to `true` to disable remote observation regardless of the saved preference. |
32
34
 
33
- Collection defaults to enabled. Local commands send no remote signals.
35
+ The published CLI includes Capxul-owned public ingestion configuration. You do
36
+ not need PostHog environment variables. Collection defaults to enabled for
37
+ ordinary local and online commands, help, version, and safely attributed argument
38
+ refusals. Parser refusals produce a completion without a start. Early native
39
+ global errors with no resolved command route send nothing, because the CLI
40
+ cannot determine whether they belong to a silent collection control.
34
41
  `telemetry disable` saves one preference for the OS user and sends no final
35
42
  remote event. Already running CLI processes check the current preference before
36
43
  each export. Requests already sent cannot be recalled. `telemetry status`
37
44
  reports the stored preference, effective policy, configuration, and reason.
45
+ `--log-level` controls normal diagnostic output, not collection. An eligible
46
+ invocation still produces its remote completion unless collection is disabled.
47
+
48
+ Eligible commands reuse a random anonymous identifier stored in the protected
49
+ CLI directory. Invocation and trace identifiers remain separate. A first-use
50
+ marker records the first eligible observed use, not a download or a verified
51
+ person. If this state cannot be accessed safely, observation stops and the
52
+ command retains its normal result. Delivery is bounded and best-effort; the CLI
53
+ does not keep a persistent activity queue.
38
54
 
39
55
  Settings use a versioned JSON file in a directory with mode `0700`. The file has
40
56
  mode `0600`. Writes are atomic and serialize between processes. A later writer