Read promotion context for a promoted run
Details
Promotion context is compact selection-audit metadata written by
ledgr_promote(). It stores the selected candidate, source sweep metadata,
and the filtered/sorted candidate-summary view used at selection time. It is
not a full sweep artifact and does not store full ledger rows or equity
curves for all candidates. For sweep-promoted runs,
ledgr_metric_context(ledgr_promotion_context(bt)) returns the source sweep
metric context used to rank the candidate. The committed run's own metric
context remains available from ledgr_metric_context(bt).
Records written by ledgr_promotion_v3 carry identity_check: the
candidate's and the promoting run's identity hashes (candidate,
promoting), the identities that differed (mismatched) and those the
candidate's sweep did not record (not_recorded). Stored promotion context
records must use the current ledgr_promotion_v3 representation. Version 3
also carries authored and candidate-resolved strategy-schedule identity.
Articles
Exploratory sweeps and promotion:
vignette("sweeps", package = "ledgr")
system.file("doc", "sweeps.html", package = "ledgr")