@tangle-network/traces 0.11.4 → 0.11.5
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 +7 -0
- package/dist/{chunk-AGPOIWPQ.js → chunk-VTYOCFGF.js} +1019 -85
- package/dist/cli.js +64 -5
- package/dist/index.d.ts +288 -4
- package/dist/index.js +36 -74
- package/docs/replay-verify.md +17 -0
- package/docs/trace-analysts.md +28 -0
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -260,9 +260,13 @@ traces upload --since 1h --dry-run # redact + dedup + preview, n
|
|
|
260
260
|
traces upload --since 24h # upload last day to the Intelligence Platform
|
|
261
261
|
traces replay-verify --steps steps.json --image <docker-image> --at 37 --cwd /home --out ./replay-out \
|
|
262
262
|
--fix-command "<corrected step>" # executed proof: replay prefix, reproduce failure, show fix
|
|
263
|
+
traces verify-findings --findings findings.json --out ./receipts \
|
|
264
|
+
--steps steps.json --image <replay-ready-image> --cwd /app # execute recorded analyst findings as proofs
|
|
265
|
+
traces analyze --last 1 --llm --verify-findings --replay-corpus h=labels.json::prepared/ # proof-carrying analyze
|
|
263
266
|
```
|
|
264
267
|
|
|
265
268
|
`replay-verify` replays a CodeTraceBench-style trajectory prefix in a real sandbox and executes step k twice — recorded (does the failure reproduce?) and corrected (does it vanish?).
|
|
269
|
+
`verify-findings` runs that proof per analyst finding and annotates each with `reproduced | fix-flipped | divergent | not-replayable` plus a receipt directory; see [Verified findings](./docs/trace-analysts.md#verified-findings-executed-replay).
|
|
266
270
|
See [Replay verification](./docs/replay-verify.md) for setup, semantics, and honest limits (SWE-style trajectories with a docker image only; commands run as the non-root sandbox user).
|
|
267
271
|
|
|
268
272
|
| Flag | Meaning |
|
|
@@ -288,6 +292,9 @@ See [Replay verification](./docs/replay-verify.md) for setup, semantics, and hon
|
|
|
288
292
|
| `--min-loop <n>` | Identical repeated calls before flagging a loop (default 3) |
|
|
289
293
|
| `--mode <kind>` | `stream`: `visualizer` (spans + findings), `findings` (low-volume), or `agent` (findings + reports) |
|
|
290
294
|
| `--supervisor-run-dir <dir>` | `analyze`: report one run tree; `watch`: tail it live |
|
|
295
|
+
| `--verify-findings` | `analyze`: execute the findings as sandbox replay proofs; each is marked VERIFIED (receipt path) or UNVERIFIABLE (reason). Needs `--replay-corpus` and a running sandbox (`SANDBOX_API_KEY` / `SANDBOX_API_URL`) |
|
|
296
|
+
| `--replay-corpus name=<labels>::<prepared>` | Trajectory source for `--verify-findings` (repeatable) |
|
|
297
|
+
| `--verify-out <dir>` | Receipt root for `--verify-findings` (default: `<--out>.verify`) |
|
|
291
298
|
| `--replay` | `stream`: scan once, then exit |
|
|
292
299
|
| `--once` | `stream`: scan once; `watch <target>`: print ONE snapshot and exit |
|
|
293
300
|
| `--no-spans` / `--no-findings` | `stream`: suppress raw span rows / finding rows |
|