pj/sanderling

0 Fork 0

mirror of https://github.com/priyanshujain/sanderling.git synced 2026-10-02 19:17:10 +00:00

Files

T

pj 991c583eb9 docs update with case study (#63 )

* docs(manual): add introduction page

* docs(manual): rewrite getting started as guided first run

* docs(manual): rewrite writing specs as a folio tutorial

* docs(manual): document missing spec API in reference

* docs(manual): plain-language rewrite of runs page

* docs: real introductions on index pages and README

* fix(docs): sibling links from directory-style pages need ../

* fix(docs): correct sampling and restart-cost claims to match implementation

* docs: nav lists Introduction and Case study; roadmap points to milestone

* docs(manual): make getting started target the reader's own app, not Folio

* docs(manual): add Folio case study page

* docs: point manual navigation at the case study

* docs(readme): lead with the case study, fix roadmap link

* docs: roadmap links to milestone, sync clear-data default and cross-links

2026-06-09 20:13:54 +05:30

2.1 KiB

Raw Blame History

title

title
sanderling replay

sanderling replay

Local web UI for exploring runs produced by sanderling test. Reads runs/<id>/meta.json and runs/<id>/trace.jsonl from disk.

sanderling replay [run-or-runs-dir] [--port N] [--no-open] [--dev]

The positional argument can be a runs directory or a single run directory (auto-detected by meta.json). Defaults to ./runs.

Panels

Panel	What it shows
Screenshot	Device screenshot for the focused step, with the dispatched action's target spotlit.
ActionList	Ordered list of steps with the verb and target for each action.
Timeline	Per-property lane chart over the run; cells coloured by violated, pending, or holds.
ViolationsPanel	Property statuses at the focused step with residual formulas for any that failed.
HierarchyPanel	Filterable table of every UI element captured at the focused step; mirrors the selectors documented in Spec language reference.
SnapshotTable	Flattened `snapshots` map for the focused step, with diffs against the previous step.
MetricsChart	Heap and other host-side metrics sampled per step.
ExceptionsPanel	Uncaught exceptions captured during the run, with a jump-to-first control.

Keyboard shortcuts

Key	Action
`j`, `Right`	Next step
`k`, `Left`	Previous step
`Shift+j`, `Shift+Right`	Jump 10 forward
`Shift+k`, `Shift+Left`	Jump 10 back
`g` / `G`	First / last step
`.`	Next step with a violation

Arrow keys inside a tablist or listbox yield to those widgets. Use j/k when focus is on one.

Deep links

/runs/:id/steps/:n links to a specific step. Use it in issues or PRs when pointing at a violation.

The run index auto-refreshes over SSE as new runs land, so sanderling replay and sanderling test can run side by side.

Development

Two-process loop while iterating on the UI:

make web-dev     # bun + vite on http://127.0.0.1:5173
make replay-dev  # sanderling replay --dev, proxies non-API to 5173

Single binary with the bundle embedded:

make sanderling

2.1 KiB Raw Blame History