@deslop/scope 0.1.1222 → 0.1.1223

package/README.md

@@ -1,24 +1,13 @@
 # Scope
 
-An Effect development debugger: a public OTLP/HTTP JSON receiver, queried by agents through an OAuth-protected MCP endpoint reached through the [gateway](../gateway/README.md), and read by people at `https://scope.mp281x.xyz`.
+A debugger for Effect apps: it receives their traces and logs, and agents query them.
 
-- **Runs** on dev as a service; entries under `entries/` in its data directory for three days by exporter time, at most 10 MB per export.
-- **Exporters**: `https://scope.mp281x.xyz/v1/traces` and `/v1/logs`, `content-type: application/json`, from any origin without credentials; apps pass `--traces https://scope.mp281x.xyz`, phones export there directly.
-- **MCP and the web page** need a Deslop sign-in through [Auth](../auth/README.md); no API keys.
-- **Web page**: the traces of the last three days by service, each opened as a waterfall with its spans' attributes and logs; its RPCs (`scope.services`, `scope.traces`, `scope.trace`) answer what `list_services`, `find` and `read_trace` do.
+```bash
+npm install --global @deslop/scope
+scope service install --url https://scope.mp281x.xyz --auth https://auth.mp281x.xyz
+```
 
-| Tool              | Returns                                                                                                    |
-| ----------------- | ---------------------------------------------------------------------------------------------------------- |
-| `list_services`   | Every stored service's latest run, runtime, last event time and entry count, plus rejected-export counters |
-| `find`            | Matching traces, spans with their OTLP fields, or logs, newest or slowest first, with the total count      |
-| `measure_latency` | Span count, errors and p50, p95 and max latency over the whole window                                      |
-| `read_trace`      | One stored trace whole, including earlier runs, with parent order, offsets and logs                        |
+- **Send** telemetry by starting other apps with `--traces https://scope.mp281x.xyz`; it accepts OTLP/HTTP JSON from anywhere and keeps three days.
+- **MCP** at `/mcp`: `list_services`, `find`, `read_trace`, `measure_latency`.
 
-## Ingestion health
-
-Start with `list_services`.
-
-- **Times**: `lastEventAt` and `runStartedAt` are exporter-clock Unix nanoseconds; a zero run marker means no valid run start was exported.
-- **`entries`** counts the latest run only; a missing service has no retained telemetry, which proves nothing about its health.
-- **Rejections** per route, status and credential header (`authorization`, `cookie`, `none`); they can't name the app. No credentials or bodies kept. `since` and `lastAt` are receiver-clock Unix milliseconds; counters reset on restart.
-- **No self-export**: Scope's own diagnostic traffic stays out of it.
+Common flags and service commands: [Deslop app runtime](https://github.com/MP281X/deslop/blob/main/packages/runtime/README.md).

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@deslop/scope",
-	"version": "0.1.1222",
+	"version": "0.1.1223",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/MP281X/deslop",
@@ -31,5 +31,5 @@
 	"engines": {
 		"node": ">=26"
 	},
-	"fingerprint": "a15b13f9f48cda6e7fbe56e1cf42e57e684ab7829c517dbd4d361895804b8a7b"
+	"fingerprint": "9ca31803c8c95cd5b8e0e26078bcc5a1cc5c4201c91111e2942ca39fe508cac1"
 }