Inspect one run in a ledgr experiment store — ledgr_run

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_open(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, feature_set_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. See ledgr_identity_fields for hash-field semantics.

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, cost_model = ledgr_cost_zero(), 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_20260616_144833_acc9
#> Snapshot Hash:   cedb25a2a955f01de94e988db20dccdba9457d30fe2cba360129bb632b852045
#> Feature Set Hash: 0a88f6f723b5489a2ceb2496a0031cb4bc8ddb15be59bb362c4c13f72e81d5d4
#> Config Hash:     6da74c4c13b707691c0bdfefe7eecf387da11c6a49e3aee781e17e6b2cfc9d16
#> Strategy Hash:   4eedb6b7770208578dd7997bc6c074b1a0cd263ffea399cd191189b64b60de8e
#> Params Hash:     1ea0937c818097b81d749096dc3188a84f3b5795bebda75cfcbcd515a20f8f9d
#> Reproducibility: tier_1
#> Execution Mode:  audit_log
#> Elapsed Sec:     0.751000000000005
#> Persist Features:TRUE
#> Cache Hits:      0
#> Cache Misses:    0
close(bt)
ledgr_snapshot_close(snapshot)