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_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, risk_chain_hash, config_hash, execution_timing_version, execution_timing_convention, 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. When terminal completion evidence exists, the object also reports requested and achieved windows, stop reason, last fully valued and executed times, whether performance is complete, and affected instrument identifiers. Historical or dense runs without that evidence report those fields as unknown. 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_20260914_040803_1260
#> Snapshot Hash:   cedb25a2a955f01de94e988db20dccdba9457d30fe2cba360129bb632b852045
#> Feature Set Hash: 0a88f6f723b5489a2ceb2496a0031cb4bc8ddb15be59bb362c4c13f72e81d5d4
#> Risk Chain Hash:  71863d276abfadf01e5451b8feb3ae38690b42c350db22b2740bf990358c0a11
#> Config Hash:     dc67b6004727b4f1269ff7e39f734f24f661c5aa15d22356b1011d192ea50d05
#> Strategy Hash:   4eedb6b7770208578dd7997bc6c074b1a0cd263ffea399cd191189b64b60de8e
#> Params Hash:     1ea0937c818097b81d749096dc3188a84f3b5795bebda75cfcbcd515a20f8f9d
#> Reproducibility: tier_1
#> Execution Mode:  audit_log
#> Fill Timing:     dense_bar_timestamp
#> Timing Version:  N/A
#> Elapsed Sec:     0.919000000000011
#> Persist Features:TRUE
#> Cache Hits:      0
#> Cache Misses:    0
close(bt)
ledgr_snapshot_close(snapshot)