@deslop/scope 0.0.0-stage → 0.1.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/README.md +18 -2
- package/dist/cli.js +7973 -0
- package/dist/contracts-C6i6YWAa.mjs +45502 -0
- package/package.json +45 -5
package/README.md
CHANGED
|
@@ -1,3 +1,19 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Scope
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Query the always-on Effect development debugger at https://scope.mp281x.xyz.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
npx @deslop/scope@latest login '<API key from https://auth.mp281x.xyz>'
|
|
7
|
+
npx @deslop/scope@latest services
|
|
8
|
+
npx @deslop/scope@latest traces --service @deslop/portfolio-server
|
|
9
|
+
npx @deslop/scope@latest trace <trace-id>
|
|
10
|
+
npx @deslop/scope@latest watch --service @deslop/portfolio-server
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
`login` saves the API key with owner-only permissions in `~/.deslop/scope/api-key`. The web app uses the same auth app's session cookie. `SCOPE_SERVER` or `--server` overrides the server URL.
|
|
14
|
+
|
|
15
|
+
Every query writes JSON to stdout and diagnostics to stderr. `watch` emits newline-delimited JSON when matching traces change. `trace` returns the full parent-ordered span tree, frontend/backend runtimes, offsets and logs attached to their spans. `traces`, `spans`, `logs` and `stats` accept `--service`, `--operation`, `--trace`, `--text`, `--errors`, `--since '10 minutes'`, `--limit` and `--offset`. `stats` covers the entire window rather than the first page.
|
|
16
|
+
|
|
17
|
+
Only the current application runs are visible. Deslop's runtime sets `scope.runtime`, `service.instance.id` and `scope.run.started_unix_nano` resource attributes. When a participating service exports a newer run, the whole previous trace is hidden, including its spans from other services. Uncorrelated OTLP logs remain queryable through the CLI, not a separate web log feed.
|
|
18
|
+
|
|
19
|
+
For a local server started with `NODE_ENV=development`, the shared auth package uses a mock developer. Run `scope services --dev --server http://localhost:5000`; no OAuth or API key is needed. Without `--dev`, the CLI always sends its stored API key, including from a development shell. Production requires real authentication. OTLP/HTTP JSON ingestion at `/v1/traces` and `/v1/logs` is unauthenticated.
|