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_open(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, including feature_set_hash, provenance, status, telemetry summary, and basic result summary columns. Eleven appended completion columns distinguish requested and achieved windows, completion status, prefix-only performance, and affected instruments. Five further columns flag declared valuation assumptions: valuation_state ("current", "stale", or "frozen"), frozen_instrument_sessions, max_frozen_equity_weight, frozen_at_end_value, and assumed_terminal_outcomes; ledgr_valuation_summary() gives the full evidence for one run. Typed missing values mean that completion or availability evidence is unavailable. Print adds attempted, done, incomplete, and failed counts. See ledgr_identity_fields for hash-field semantics.

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, cost_model = ledgr_cost_zero(), opening = ledgr_opening(cash = 1000))
bt <- ledgr_run(exp, params = list(), run_id = "flat")
ledgr_run_list(snapshot)
#> # ledgr run list
#> # A tibble: 1 × 11
#>   run_id label tags  status final_equity total_return complete_performance
#>   <chr>  <chr> <chr> <chr>         <dbl> <chr>        <lgl>               
#> 1 flat   NA    NA    DONE           1000 +0.0%        NA                  
#>   achieved_end_utc valuation_state execution_mode reproducibility_level
#>   <dttm>           <chr>           <chr>          <chr>                
#> 1 NA               NA              audit_log      tier_1               
#> 
#> # i 1 runs attempted: 1 done, 0 incomplete, 0 failed.
#> # i INCOMPLETE metrics describe the achieved prefix only.
#> # 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)