List runs in a ledgr experiment store

Discovers stored runs in a DuckDB experiment-store file without recomputing or mutating runs. Archived runs are hidden by default.

Usage

ledgr_run_list(snapshot, include_archived = FALSE)

Arguments

snapshot

A sealed ledgr_snapshot object. Use ledgr_snapshot_load(db_path, snapshot_id) to resume from a durable DuckDB file in a new R session.

include_archived

Logical scalar. If TRUE, include archived runs.

Value

A ledgr_run_list object, which is a classed tibble with run identity, provenance, status, telemetry summary, and basic result summary columns.

Examples

bars <- subset(ledgr_demo_bars, instrument_id == "DEMO_01")
snapshot <- ledgr_snapshot_from_df(utils::head(bars, 10))
strategy <- function(ctx, params) ctx$flat()
exp <- ledgr_experiment(snapshot, strategy, opening = ledgr_opening(cash = 1000))
bt <- ledgr_run(exp, params = list(), run_id = "flat")
ledgr_run_list(snapshot)
#> # ledgr run list
#> # A tibble: 1 × 8
#>   run_id label tags  status final_equity total_return execution_mode
#>   <chr>  <chr> <lgl> <chr>         <dbl> <chr>        <chr>         
#> 1 flat   NA    NA    DONE           1000 +0.0%        audit_log     
#> # ℹ 1 more variable: reproducibility_level <chr>
#> 
#> # i Full identity and telemetry columns remain available on this tibble.
#> # i Inspect one run with ledgr_run_info(snapshot, run_id).
close(bt)
ledgr_snapshot_close(snapshot)