Inspect one run in a ledgr experiment store

Returns a structured ledgr_run_info object for a stored run. This function reads run metadata and diagnostics only; it does not execute strategy code.

Usage

ledgr_run_info(snapshot, run_id)

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

Run identifier.

Value

A ledgr_run_info object. Important fields include run_id, status, snapshot_id, snapshot_hash, strategy_source_hash, strategy_params_hash, config_hash, reproducibility_level, execution_mode, elapsed_sec, pulse_count, persist_features, feature-cache counts, promotion_context for runs created with ledgr_promote(), and error_msg for failed runs.

Articles

Exploratory sweeps and promotion: vignette("sweeps", package = "ledgr") system.file("doc", "sweeps.html", package = "ledgr")

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_info(snapshot, bt$run_id)
#> ledgr Run Info
#> ==============
#> 
#> Run ID:          flat
#> Label:           NA
#> Status:          DONE
#> Archived:        FALSE
#> Tags:            NA
#> Snapshot:        snapshot_20260515_162028_f339
#> Snapshot Hash:   cedb25a2a955f01de94e988db20dccdba9457d30fe2cba360129bb632b852045
#> Config Hash:     4e6e38b84ddb17bfd108b41cd2a4994e5fd27f85ed50d4c87cbbd82d367d3af7
#> Strategy Hash:   4eedb6b7770208578dd7997bc6c074b1a0cd263ffea399cd191189b64b60de8e
#> Params Hash:     071685bbedd79b55e3cadcf0089a6d740ffa729e425e34aef44a8beab9a67c87
#> Reproducibility: tier_1
#> Execution Mode:  audit_log
#> Elapsed Sec:     0.497
#> Persist Features:TRUE
#> Cache Hits:      0
#> Cache Misses:    0
close(bt)
ledgr_snapshot_close(snapshot)