Archive a run without deleting artifacts

Marks a stored run as archived so it is hidden from default run lists while remaining inspectable and, if completed, reopenable. Archiving is idempotent and does not rewrite existing archive metadata.

Usage

ledgr_run_archive(snapshot, run_id, reason = 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

Run identifier.

reason

Optional archive reason. Empty strings are stored as NULL.

Value

The input ledgr_snapshot, invisibly.

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_archive(snapshot, bt$run_id, reason = "example cleanup")
close(bt)
ledgr_snapshot_close(snapshot)