List run tags

Lists mutable run tags stored in a ledgr experiment store. This is a read-only operation and does not migrate legacy stores.

Usage

ledgr_run_tags(snapshot, run_id = NULL)

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.

run_id

Optional run identifier. If supplied, list tags for that run only.

Value

A tibble with run_id, tag, and created_at_utc.

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_tag(snapshot, bt$run_id, "baseline")
ledgr_run_tags(snapshot)
#> # A tibble: 1 × 3
#>   run_id tag      created_at_utc      
#>   <chr>  <chr>    <chr>               
#> 1 flat   baseline 2026-05-15T16:20:36Z
close(bt)
ledgr_snapshot_close(snapshot)